react-magic-search-params 1.0.1 → 1.1.3

package/dist/react-magic-search-params.cjs.development.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-magic-search-params.cjs.development.js","sources":["../src/useMagicSearchParams.ts"],"sourcesContent":["import { useSearchParams } from 'react-router-dom'\r\nimport { useMemo, useEffect, useRef, useCallback } from 'react'\r\n\r\n\r\n// Custom hook with advanced techniques to handle search parameters for any pagination\r\n\r\ntype CommonParams = {\r\n  page?: number\r\n  page_size?: number\r\n}\r\n/*\r\nMaps all properties of M (mandatory) as required\r\nand all properties of O (optional) as optional. \r\n*/\r\ntype MergeParams<M, O> = {\r\n  [K in keyof M]: M[K]\r\n} & {\r\n  [K in keyof O]?: O[K]\r\n}\r\n/**\r\n * Interface for the configuration object that the hook receives \r\n */\r\nexport interface UseMagicSearchParamsOptions<\r\n  M extends Record<string, unknown>,\r\n  O extends Record<string, unknown>\r\n> {\r\n  mandatory: M \r\n  optional?: O\r\n  defaultParams?: Partial<MergeParams<M, O>>\r\n  forceParams?: Partial<MergeParams<M, O>> // transform all to partial to avoid errors\r\n  arraySerialization?: 'csv' | 'repeat' | 'brackets' // technical to serialize arrays in the URL\r\n  omitParamsByValues?: Array<'all' | 'default' | 'unknown' | 'none' | 'void '> \r\n}\r\n\r\n/** \r\nGeneric hook to handle search parameters in the URL\r\n@param mandatory - Mandatory parameters (e.g., page=1, page_size=10, etc.)\r\n@param optional - Optional parameters (e.g., order, search, etc.)\r\n@param defaultParams - Default parameters sent in the URL on initialization\r\n@param forceParams - Parameters forced into the URL regardless of user input\r\n@param omitParamsByValues - Parameters omitted if they have specific values \r\n*/\r\nexport const useMagicSearchParams = <\r\n  M extends Record<string, unknown> & CommonParams,\r\n  O extends Record<string, unknown>,\r\n>({\r\n  mandatory = {} as M,\r\n  optional = {} as O,\r\n  defaultParams = {} as Partial<MergeParams<M, O>>,\r\n  arraySerialization = 'csv',\r\n  forceParams = {} as  {} as Partial<MergeParams<M, O>>,\r\n  omitParamsByValues = [] as Array<'all' | 'default' | 'unknown' | 'none' | 'void '>\r\n}: UseMagicSearchParamsOptions<M, O>)=> {\r\n\r\n\r\n  const [searchParams, setSearchParams] = useSearchParams() \r\n    // Ref to store subscriptions: { paramName: [callback1, callback2, ...] }\r\n  const subscriptionsRef = useRef<Record<string, Array<() => unknown>>>({}); \r\n  const previousParamsRef = useRef<Record<string, unknown>>({})\r\n\r\n  const TOTAL_PARAMS_PAGE: MergeParams<M, O> = useMemo(() => {\r\n    return { ...mandatory, ...optional };\r\n  }, [mandatory, optional]);\r\n\r\n  const PARAM_ORDER = useMemo(() => {\r\n    return Array.from(Object.keys(TOTAL_PARAMS_PAGE))\r\n  }, [TOTAL_PARAMS_PAGE])\r\n\r\n  // we get the keys that are arrays according to TOTAL_PARAMS_PAGE since these require special treatment in the URL due to serialization mode\r\n  const ARRAY_KEYS = useMemo(() => {\r\n    return Object.keys(TOTAL_PARAMS_PAGE).filter(\r\n      (key) => Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n    );\r\n  }, [TOTAL_PARAMS_PAGE])\r\n\r\n  const appendArrayValues = (\r\n    finallyParams: Record<string, unknown>,\r\n    newParams: Record<string, string | string[] | unknown>\r\n  ): Record<string, unknown> => {\r\n \r\n    // Note: We cannot modify the object of the final parameters directly, as immutability must be maintained\r\n    const updatedParams = { ...finallyParams };\r\n  \r\n\r\n    if (ARRAY_KEYS.length === 0) return updatedParams;\r\n  \r\n    ARRAY_KEYS.forEach((key) => {\r\n      // We use the current values directly from searchParams (source of truth)\r\n      // This avoids depending on finallyParams in which the arrays have been omitted\r\n      let currentValues = []; \r\n      switch (arraySerialization) {\r\n        case 'csv': {\r\n          const raw = searchParams.get(key) || '';\r\n          // For csv we expect \"value1,value2,...\" (no prefix)\r\n          currentValues = raw.split(',')\r\n            .map((v) => v.trim())\r\n            .filter(Boolean) as Array<string>\r\n          break;\r\n        }\r\n        case 'repeat': {\r\n          // Here we get all ocurrences of key\r\n          const urlParams = searchParams.getAll(key) as Array<string>\r\n          currentValues = urlParams.length > 0 ? urlParams : []\r\n          \r\n          console.log({REPEAT: currentValues})\r\n          break;\r\n        }\r\n        case 'brackets': {\r\n           // Build URLSearchParams from current parameters (to ensure no serialized values are taken previously)\r\n            const urlParams = searchParams.getAll(`${key}[]`) as Array<string>\r\n            currentValues = urlParams.length > 0 ? urlParams : []\r\n            console.log({BRACKETS: urlParams})\r\n        \r\n    \r\n            break;\r\n        }\r\n        default: {\r\n          // Mode by default works as csv\r\n          const raw = searchParams.get(key) ?? '';\r\n          currentValues = raw.split(',')\r\n            .map((v) => v.trim())\r\n            .filter(Boolean);\r\n          }\r\n        break; \r\n      }\r\n      // Update array values with new ones\r\n    \r\n      if (newParams[key] !== undefined) {\r\n        const incoming = newParams[key];\r\n        let combined: string[] = []\r\n        if (typeof incoming === 'string') {\r\n          // If it is a string, it is toggled (add/remove)\r\n          combined = currentValues.includes(incoming)\r\n            ? currentValues.filter((v) => v !== incoming)\r\n            : [...currentValues, incoming];\r\n          console.log({currentValues})\r\n            console.log({incoming})\r\n          console.log({CONBINED_STRING: combined})\r\n        } else if (Array.isArray(incoming)) {\r\n          // if an array is passed, repeated values are merged into a single value\r\n          // Note: Set is used to remove duplicates\r\n          combined = Array.from(new Set([ ...incoming]));\r\n          console.log({incoming})\r\n          console.log({combined})\r\n        } else {\r\n       \r\n          combined = currentValues;\r\n        }\r\n\r\n        updatedParams[key] = combined\r\n\r\n      }\r\n    });\r\n    console.log({updatedParams})\r\n    return updatedParams\r\n  };\r\n\r\n  const transformParamsToURLSearch = (params: Record<string, unknown>): URLSearchParams => {\r\n    console.log({PARAMS_RECIBIDOS_TRANSFORM: params})\r\n\r\n    const newParam: URLSearchParams = new URLSearchParams()\r\n\r\n    const paramsKeys = Object.keys(params)\r\n\r\n    for (const key of paramsKeys) {\r\n      if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n        const arrayValue = params[key] as unknown[]\r\n        console.log({arrayValue})\r\n        switch (arraySerialization) {\r\n          case 'csv': {\r\n            const csvValue = arrayValue.join(',')\r\n            // set ensure that the previous value is replaced\r\n            newParam.set(key, csvValue)\r\n            break\r\n          } case 'repeat': {\r\n      \r\n            for (const item of arrayValue) {\r\n              console.log({item})\r\n              // add new value to the key, instead of replacing it\r\n              newParam.append(key, item as string)\r\n   \r\n            }\r\n            break\r\n          } case 'brackets': {\r\n            for (const item of arrayValue) {\r\n              newParam.append(`${key}[]`, item as string)\r\n            }\r\n            break\r\n          } default: {\r\n            const csvValue = arrayValue.join(',')\r\n            newParam.set(key, csvValue)\r\n          }\r\n        }\r\n      } else {\r\n        newParam.set(key, params[key] as string)\r\n      }\r\n    }\r\n    console.log({FINAL: newParam.toString()})\r\n    return newParam\r\n  }\r\n  // @ts-ignore\r\n  const hasForcedParamsValues = ({ paramsForced, compareParams }) => {\r\n\r\n    // Iterates over the forced parameters and verifies that they exist in the URL and match their values\r\n    // Ej: { page: 1, page_size: 10 } === { page: 1, page_size: 10 } => true\r\n    const allParamsMatch = Object.entries(paramsForced).every(\r\n      ([key, value]) => compareParams[key] === value\r\n    );\r\n\r\n    return allParamsMatch;\r\n  };\r\n  \r\n  useEffect(() => {\r\n\r\n    const keysDefaultParams: string[] = Object.keys(defaultParams)\r\n    const keysForceParams: string[] = Object.keys(forceParams)\r\n    if(keysDefaultParams.length === 0 && keysForceParams.length === 0) return\r\n  \r\n\r\n    function handleStartingParams() {\r\n\r\n      const defaultParamsString  = transformParamsToURLSearch(defaultParams).toString()\r\n      const paramsUrl = getParams()\r\n      const paramsUrlString = transformParamsToURLSearch(paramsUrl).toString()\r\n      const forceParamsString = transformParamsToURLSearch(forceParams).toString()\r\n\r\n      console.log({defaultParamsString})\r\n\r\n      const isForcedParams: boolean = hasForcedParamsValues({ paramsForced: forceParams, compareParams: paramsUrl })\r\n\r\n      if (!isForcedParams) {\r\n\r\n        // In this case, the forced parameters take precedence over the default parameters and the parameters of the current URL (which could have been modified by the user, e.g., page_size=1000)\r\n\r\n        updateParams({ newParams: {\r\n          ...defaultParams,\r\n          ...forceParams\r\n        }})\r\n        return\r\n      }\r\n      // In this way it will be validated that the forced parameters keys and values are in the current URL\r\n      const isIncludesForcedParams = hasForcedParamsValues({ paramsForced: forceParamsString, compareParams: defaultParams })\r\n\r\n      if (keysDefaultParams.length > 0 && isIncludesForcedParams) {\r\n        if (defaultParamsString === paramsUrlString) return // this means that the URL already has the default parameters\r\n        updateParams({ newParams: defaultParams })\r\n      }\r\n\r\n    }\r\n    handleStartingParams()\r\n\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  }, [])\r\n\r\n  /**\r\n   * Convert a string value to its original type (number, boolean, array) according to TOTAL_PARAMS_PAGE\r\n   * @param value - Chain obtained from the URL\r\n   * @param key - Key of the parameter\r\n   */\r\n  const convertOriginalType = (value: string, key: string) => {\r\n    // Given that the parameters of a URL are recieved as strings, they are converted to their original type\r\n    if (typeof TOTAL_PARAMS_PAGE[key] === 'number') {\r\n      return parseInt(value)\r\n    } else if (typeof TOTAL_PARAMS_PAGE[key] === 'boolean') {\r\n      return value === 'true'\r\n    } else if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n      // The result will be a valid array represented in the URL ej: tags=tag1,tag2,tag3 to ['tag1', 'tag2', 'tag3'], useful to combine the values of the arrays with the new ones\r\n \r\n      if (arraySerialization === 'csv') {\r\n        return searchParams.getAll(key).join('').split(',')\r\n      } else if (arraySerialization === 'repeat') {\r\n    \r\n        console.log({SEARCH_PARAMS: searchParams.getAll(key)})\r\n        return searchParams.getAll(key)\r\n      } else if (arraySerialization === 'brackets') {\r\n        return searchParams.getAll(`${key}[]`)\r\n      }\r\n     \r\n     \r\n    }\r\n    // Note: dates are not converted as it is better to handle them directly in the component that receives them, using a library like < date-fns >\r\n    return value\r\n  }\r\n  \r\n    /**\r\n   * Gets the current parameters from the URL and converts them to their original type if desired\r\n   * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n   */\r\n    const getStringUrl = (key: string, paramsUrl: Record<string, unknown>) => {\r\n      const isKeyArray = Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n      if (isKeyArray) {\r\n\r\n        if (arraySerialization === 'brackets') {\r\n\r\n          const arrayUrl = searchParams.getAll(`${key}[]`)\r\n          const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayUrl }).toString()\r\n          // in this way the array of the URL is decoded to its original form ej: tags[]=tag1&tags[]=tag2&tags[]=tag3\r\n          const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n          return unencodeQuery\r\n        } else if (arraySerialization === 'csv') {\r\n          const arrayValue = searchParams.getAll(key)\r\n          const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n          const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n          return unencodeQuery\r\n        }\r\n        const arrayValue = searchParams.getAll(key)\r\n        const stringResult = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n        return stringResult\r\n      } else {\r\n   \r\n        return paramsUrl[key] as string\r\n      }\r\n     }\r\n     const getParamsObj = (searchParams: URLSearchParams): Record<string, string | string[]> => {\r\n      const paramsObj: Record<string, string | string[]> = {};\r\n      // @ts-ignore\r\n      for (const [key, value] of searchParams.entries()) {\r\n        if (key.endsWith('[]')) {\r\n          const bareKey = key.replace('[]', '');\r\n          if (paramsObj[bareKey]) {\r\n            (paramsObj[bareKey] as string[]).push(value);\r\n          } else {\r\n            paramsObj[bareKey] = [value];\r\n          }\r\n        } else {\r\n          // If the key already exists, it is a repeated parameter\r\n          if (paramsObj[key]) {\r\n            if (Array.isArray(paramsObj[key])) {\r\n              (paramsObj[key] as string[]).push(value);\r\n            } else {\r\n              paramsObj[key] = [paramsObj[key] as string, value];\r\n            }\r\n          } else {\r\n            paramsObj[key] = value;\r\n          }\r\n        }\r\n      }\r\n      return paramsObj;\r\n     }\r\n    // Optimization: While the parameters are not updated, the current parameters of the URL are not recalculated\r\n    const CURRENT_PARAMS_URL: Record<string, unknown> = useMemo(() => {\r\n\r\n      return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries())\r\n    }, [searchParams, arraySerialization])\r\n\r\n    const getParams = ({ convert = true } = {}): MergeParams<M, O> => {\r\n      // All the paramteres are extracted from the URL and converted into an object\r\n\r\n      const params = Object.keys(CURRENT_PARAMS_URL).reduce((acc, key) => {\r\n        if (Object.prototype.hasOwnProperty.call(TOTAL_PARAMS_PAGE, key)) {\r\n          const realKey = arraySerialization === 'brackets' ? key.replace('[]', '') : key\r\n          // @ts-ignore\r\n          acc[realKey] = convert === true\r\n            ? convertOriginalType(CURRENT_PARAMS_URL[key] as string, key)\r\n            :  getStringUrl(key, CURRENT_PARAMS_URL)\r\n        }\r\n        return acc\r\n      }, {})\r\n  \r\n      return params as MergeParams<M, O>\r\n    }\r\n  type keys = keyof MergeParams<M, O>\r\n  // Note: in this way the return of the getParam function is typed dynamically, thus having autocomplete in the IDE (eg: value.split(','))\r\n  type TagReturn<T extends boolean> = T extends true ? string[] : string;\r\n  const getParam = <T extends boolean>(key: keys, options?: { convert: T }): TagReturn<T>  => {\r\n\r\n    const keyStr = String(key)\r\n    // @ts-ignore\r\n    const value = options?.convert === true ? convertOriginalType(searchParams.get(keyStr), keyStr) : getStringUrl(keyStr,  CURRENT_PARAMS_URL)\r\n    return value as TagReturn<T> \r\n  }\r\n  \r\n  type OptionalParamsFiltered = Partial<O>\r\n\r\n  const calculateOmittedParameters = (newParams: Record<string, unknown | unknown[]>, keepParams: Record<string, boolean>) => {\r\n    // Calculate the ommited parameters, that is, the parameters that have not been sent in the request\r\n    const params = getParams()\r\n    // hasOw\r\n    // Note: it will be necessary to omit the parameters that are arrays because the idea is not to replace them but to add or remove some values\r\n    const newParamsWithoutArray = Object.entries(newParams).filter(([key,]) => !Array.isArray(TOTAL_PARAMS_PAGE[key]))\r\n    const result = Object.assign({\r\n      ...params,\r\n      ...Object.fromEntries(newParamsWithoutArray),\r\n      ...forceParams // the forced parameters will always be sent and will maintain their value\r\n    })\r\n    const paramsFiltered: OptionalParamsFiltered = Object.keys(result).reduce((acc, key) => {\r\n      // for default no parameters are omitted unless specified in the keepParams object\r\n      if (Object.prototype.hasOwnProperty.call(keepParams, key) && keepParams[key] === false) {\r\n        return acc\r\n      // Note: They array of parameters omitted by values (e.g., ['all', 'default']) are omitted since they are usually a default value that is not desired to be sent\r\n      } else if (!!result[key] !== false && !omitParamsByValues.includes(result[key])) {\r\n        // @ts-ignore\r\n        acc[key] = result[key]\r\n      }\r\n\r\n      return acc\r\n    }, {})\r\n\r\n    return {\r\n      ...mandatory,\r\n      ...paramsFiltered\r\n    } \r\n  }\r\n    // @ts-ignore\r\n  const sortParameters = (paramsFiltered) => {\r\n    // sort the parameters according to the structure so that it persists with each change in the URL, eg: localhost:3000/?page=1&page_size=10\r\n    // Note: this visibly improves the user experience\r\n    const orderedParams = PARAM_ORDER.reduce((acc, key) => {\r\n      if (Object.prototype.hasOwnProperty.call(paramsFiltered, key)) {\r\n          // @ts-ignore\r\n        acc[key] = paramsFiltered[key]\r\n      }\r\n\r\n      return acc\r\n    }, {})\r\n    return orderedParams\r\n  }\r\n\r\n  const mandatoryParameters = () => {\r\n    // Note: in case there are arrays in the URL, they are converted to their original form ej: tags=['tag1', 'tag2'] otherwise the parameters are extracted without converting to optimize performance\r\n    const isNecessaryConvert: boolean = ARRAY_KEYS.length > 0 ? true : false\r\n    const totalParametros: Record<string, unknown>  = getParams({ convert: isNecessaryConvert })\r\n\r\n    const paramsUrlFound: Record<string, boolean> = Object.keys(totalParametros).reduce(\r\n      (acc, key) => {\r\n        if (Object.prototype.hasOwnProperty.call(mandatory, key)) {\r\n          // @ts-ignore\r\n          acc[key] = totalParametros[key]\r\n        }\r\n        return acc\r\n      },\r\n      {}\r\n    )\r\n\r\n    return paramsUrlFound\r\n  }\r\n\r\n  const clearParams = ({ keepMandatoryParams = true } = {}): void => {\r\n    // for default, the mandatory parameters are not cleared since the current pagination would be lost\r\n    const paramsTransformed = transformParamsToURLSearch(\r\n      {\r\n        ...mandatory,\r\n     \r\n         ...(keepMandatoryParams && {\r\n          ...mandatoryParameters()\r\n        }),\r\n        ...forceParams \r\n      }\r\n    )\r\n    setSearchParams(paramsTransformed) \r\n  }\r\n\r\n  // transforms the keys to boolean to know which parameters to keep\r\n  type KeepParamsTransformedValuesBoolean = Partial<Record<keyof typeof TOTAL_PARAMS_PAGE, boolean>>\r\n  type NewParams = Partial<typeof TOTAL_PARAMS_PAGE> \r\n  type KeepParams = KeepParamsTransformedValuesBoolean\r\n  const updateParams = ({ newParams = {} as NewParams, keepParams = {} as KeepParams } = {}) => {\r\n\r\n    if (\r\n      Object.keys(newParams).length === 0 &&\r\n      Object.keys(keepParams).length === 0\r\n    ) {\r\n      clearParams()\r\n      return\r\n    }\r\n    // @ts-ignore\r\n    const finallyParamters = calculateOmittedParameters(newParams, keepParams)\r\n\r\n    const convertedArrayValues = appendArrayValues(finallyParamters, newParams)\r\n\r\n    const paramsSorted = sortParameters(convertedArrayValues)\r\n\r\n    setSearchParams(transformParamsToURLSearch(paramsSorted))\r\n\r\n  }\r\n\r\n    // only for the keys of the parameters to subscribe to changes in the URL to trigger the callback\r\n    const onChange = useCallback( (paramName: keys, callbacks: Array<() => void>) => {\r\n      const paramNameStr = String(paramName)\r\n      // replace the previous callbacks with the new ones so as not to accumulate callbacks\r\n      subscriptionsRef.current[paramNameStr] = callbacks;\r\n    }, [])\r\n  \r\n    // each time searchParams changes, we notify the subscribers\r\n    useEffect(() => {\r\n\r\n      for (const [key, value] of Object.entries(subscriptionsRef.current)) {\r\n\r\n        const newValue = CURRENT_PARAMS_URL[key] ?? null \r\n        const oldValue = previousParamsRef.current[key] ?? null\r\n        if (newValue !== oldValue) {\r\n          \r\n          for (const callback of value) {\r\n            console.log(value)\r\n\r\n            callback()\r\n\r\n          }\r\n        }\r\n        // once the callback is executed, the previous value is updated to ensure that the next time the value changes, the callback is executed\r\n        previousParamsRef.current[key] = newValue\r\n      }\r\n\r\n      \r\n    }, [CURRENT_PARAMS_URL])\r\n  return {\r\n    searchParams,\r\n    updateParams,\r\n    clearParams,\r\n    getParams,\r\n    getParam,\r\n    onChange\r\n  }\r\n}\r\n"],"names":["useMagicSearchParams","_ref","mandatory","_ref$mandatory","_ref$optional","optional","_ref$defaultParams","defaultParams","_ref$arraySerializati","arraySerialization","_ref$forceParams","forceParams","_ref$omitParamsByValu","omitParamsByValues","_useSearchParams","useSearchParams","searchParams","setSearchParams","subscriptionsRef","useRef","previousParamsRef","TOTAL_PARAMS_PAGE","useMemo","_extends","PARAM_ORDER","Array","from","Object","keys","ARRAY_KEYS","filter","key","isArray","appendArrayValues","finallyParams","newParams","updatedParams","length","forEach","currentValues","raw","get","split","map","v","trim","Boolean","urlParams","getAll","console","log","REPEAT","BRACKETS","_searchParams$get","undefined","incoming","combined","includes","concat","CONBINED_STRING","Set","transformParamsToURLSearch","params","PARAMS_RECIBIDOS_TRANSFORM","newParam","URLSearchParams","paramsKeys","_i","_paramsKeys","arrayValue","csvValue","join","set","_iterator","_createForOfIteratorHelperLoose","_step","done","item","value","append","_iterator2","_step2","FINAL","toString","hasForcedParamsValues","_ref2","paramsForced","compareParams","allParamsMatch","entries","every","_ref3","useEffect","keysDefaultParams","keysForceParams","handleStartingParams","defaultParamsString","paramsUrl","getParams","paramsUrlString","forceParamsString","isForcedParams","updateParams","isIncludesForcedParams","convertOriginalType","parseInt","SEARCH_PARAMS","getStringUrl","isKeyArray","_transformParamsToURL3","_transformParamsToURL","arrayUrl","encodedQueryArray","unencodeQuery","decodeURIComponent","_transformParamsToURL2","stringResult","getParamsObj","paramsObj","_iterator3","_step3","_step3$value","endsWith","bareKey","replace","push","CURRENT_PARAMS_URL","fromEntries","_temp","_ref4$convert","_ref4","convert","reduce","acc","prototype","hasOwnProperty","call","realKey","getParam","options","keyStr","String","calculateOmittedParameters","keepParams","newParamsWithoutArray","_ref5","result","assign","paramsFiltered","sortParameters","orderedParams","mandatoryParameters","isNecessaryConvert","totalParametros","paramsUrlFound","clearParams","_temp2","_ref6$keepMandatoryPa","_ref6","keepMandatoryParams","paramsTransformed","_temp3","_ref7$newParams","_ref7","_ref7$keepParams","finallyParamters","convertedArrayValues","paramsSorted","onChange","useCallback","paramName","callbacks","paramNameStr","current","_i2","_Object$entries","_CURRENT_PARAMS_URL$k","_previousParamsRef$cu","_Object$entries$_i","newValue","oldValue","_iterator4","_step4","callback"],"mappings":"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"}
+{"version":3,"file":"react-magic-search-params.cjs.development.js","sources":["../src/useMagicSearchParams.ts"],"sourcesContent":["import { useSearchParams } from 'react-router-dom'\r\nimport { useMemo, useEffect, useRef, useCallback } from 'react'\r\n\r\n\r\n// Custom hook with advanced techniques to handle search parameters for any pagination\r\n\r\ntype CommonParams = {\r\n  page?: number\r\n  page_size?: number\r\n}\r\n/*\r\nMaps all properties of M (mandatory) as required\r\nand all properties of O (optional) as optional. \r\n*/\r\ntype MergeParams<M, O> = {\r\n  [K in keyof M]: M[K]\r\n} & {\r\n  [K in keyof O]?: O[K]\r\n}\r\n/**\r\n * Interface for the configuration object that the hook receives \r\n */\r\nexport interface UseMagicSearchParamsOptions<\r\n  M extends Record<string, unknown>,\r\n  O extends Record<string, unknown>\r\n> {\r\n  mandatory: M \r\n  optional?: O\r\n  defaultParams?: Partial<MergeParams<M, O>>\r\n  forceParams?: Partial<MergeParams<M, O>> // transform all to partial to avoid errors\r\n  arraySerialization?: 'csv' | 'repeat' | 'brackets' // technical to serialize arrays in the URL\r\n  omitParamsByValues?: Array<'all' | 'default' | 'unknown' | 'none' | 'void '> \r\n}\r\n\r\n/** \r\nGeneric hook to handle search parameters in the URL\r\n@param mandatory - Mandatory parameters (e.g., page=1, page_size=10, etc.)\r\n@param optional - Optional parameters (e.g., order, search, etc.)\r\n@param defaultParams - Default parameters sent in the URL on initialization\r\n@param forceParams - Parameters forced into the URL regardless of user input\r\n@param omitParamsByValues - Parameters omitted if they have specific values \r\n*/\r\nexport const useMagicSearchParams = <\r\n  M extends Record<string, unknown> & CommonParams,\r\n  O extends Record<string, unknown>,\r\n>({\r\n  mandatory = {} as M,\r\n  optional = {} as O,\r\n  defaultParams = {} as Partial<MergeParams<M, O>>,\r\n  arraySerialization = 'csv',\r\n  forceParams = {} as  {} as Partial<MergeParams<M, O>>,\r\n  omitParamsByValues = [] as Array<'all' | 'default' | 'unknown' | 'none' | 'void '>\r\n}: UseMagicSearchParamsOptions<M, O>)=> {\r\n\r\n  const [searchParams, setSearchParams] = useSearchParams() \r\n    // Ref to store subscriptions: { paramName: [callback1, callback2, ...] }\r\n  const subscriptionsRef = useRef<Record<string, Array<() => unknown>>>({}); \r\n  const previousParamsRef = useRef<Record<string, unknown>>({})\r\n\r\n  const TOTAL_PARAMS_PAGE: MergeParams<M, O> = useMemo(() => {\r\n    return { ...mandatory, ...optional };\r\n  }, [mandatory, optional]);\r\n\r\n  const PARAM_ORDER = useMemo(() => {\r\n    return Array.from(Object.keys(TOTAL_PARAMS_PAGE))\r\n  }, [TOTAL_PARAMS_PAGE])\r\n\r\n  // we get the keys that are arrays according to TOTAL_PARAMS_PAGE since these require special treatment in the URL due to serialization mode\r\n  const ARRAY_KEYS = useMemo(() => {\r\n    return Object.keys(TOTAL_PARAMS_PAGE).filter(\r\n      (key) => Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n    );\r\n  }, [TOTAL_PARAMS_PAGE])\r\n\r\n  const appendArrayValues = (\r\n    finallyParams: Record<string, unknown>,\r\n    newParams: Record<string, string | string[] | unknown>\r\n  ): Record<string, unknown> => {\r\n \r\n    // Note: We cannot modify the object of the final parameters directly, as immutability must be maintained\r\n    const updatedParams = { ...finallyParams };\r\n  \r\n\r\n    if (ARRAY_KEYS.length === 0) return updatedParams;\r\n  \r\n    ARRAY_KEYS.forEach((key) => {\r\n      // We use the current values directly from searchParams (source of truth)\r\n      // This avoids depending on finallyParams in which the arrays have been omitted\r\n      let currentValues = []; \r\n      switch (arraySerialization) {\r\n        case 'csv': {\r\n          const raw = searchParams.get(key) || '';\r\n          // For csv we expect \"value1,value2,...\" (no prefix)\r\n          currentValues = raw.split(',')\r\n            .map((v) => v.trim())\r\n            .filter(Boolean) as Array<string>\r\n          break;\r\n        }\r\n        case 'repeat': {\r\n          // Here we get all ocurrences of key\r\n          const urlParams = searchParams.getAll(key) as Array<string>\r\n          currentValues = urlParams.length > 0 ? urlParams : []\r\n          \r\n          console.log({REPEAT: currentValues})\r\n          break;\r\n        }\r\n        case 'brackets': {\r\n           // Build URLSearchParams from current parameters (to ensure no serialized values are taken previously)\r\n            const urlParams = searchParams.getAll(`${key}[]`) as Array<string>\r\n            currentValues = urlParams.length > 0 ? urlParams : []\r\n            console.log({BRACKETS: urlParams})\r\n        \r\n    \r\n            break;\r\n        }\r\n        default: {\r\n          // Mode by default works as csv\r\n          const raw = searchParams.get(key) ?? '';\r\n          currentValues = raw.split(',')\r\n            .map((v) => v.trim())\r\n            .filter(Boolean);\r\n          }\r\n        break; \r\n      }\r\n      // Update array values with new ones\r\n    \r\n      if (newParams[key] !== undefined) {\r\n        const incoming = newParams[key];\r\n        let combined: string[] = []\r\n        if (typeof incoming === 'string') {\r\n          // If it is a string, it is toggled (add/remove)\r\n          combined = currentValues.includes(incoming)\r\n            ? currentValues.filter((v) => v !== incoming)\r\n            : [...currentValues, incoming];\r\n          console.log({currentValues})\r\n            console.log({incoming})\r\n          console.log({CONBINED_STRING: combined})\r\n        } else if (Array.isArray(incoming)) {\r\n          // if an array is passed, repeated values are merged into a single value\r\n          // Note: Set is used to remove duplicates\r\n          combined = Array.from(new Set([ ...incoming]));\r\n          console.log({incoming})\r\n          console.log({combined})\r\n        } else {\r\n       \r\n          combined = currentValues;\r\n        }\r\n\r\n        updatedParams[key] = combined\r\n\r\n      }\r\n    });\r\n    return updatedParams\r\n  };\r\n\r\n  const transformParamsToURLSearch = (params: Record<string, unknown>): URLSearchParams => {\r\n    console.log({PARAMS_RECIBIDOS_TRANSFORM: params})\r\n\r\n    const newParam: URLSearchParams = new URLSearchParams()\r\n\r\n    const paramsKeys = Object.keys(params)\r\n\r\n    for (const key of paramsKeys) {\r\n      if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n        const arrayValue = params[key] as unknown[]\r\n        console.log({arrayValue})\r\n        switch (arraySerialization) {\r\n          case 'csv': {\r\n            const csvValue = arrayValue.join(',')\r\n            // set ensure that the previous value is replaced\r\n            newParam.set(key, csvValue)\r\n            break\r\n          } case 'repeat': {\r\n      \r\n            for (const item of arrayValue) {\r\n              console.log({item})\r\n              // add new value to the key, instead of replacing it\r\n              newParam.append(key, item as string)\r\n   \r\n            }\r\n            break\r\n          } case 'brackets': {\r\n            for (const item of arrayValue) {\r\n              newParam.append(`${key}[]`, item as string)\r\n            }\r\n            break\r\n          } default: {\r\n            const csvValue = arrayValue.join(',')\r\n            newParam.set(key, csvValue)\r\n          }\r\n        }\r\n      } else {\r\n        newParam.set(key, params[key] as string)\r\n      }\r\n    }\r\n    return newParam\r\n  }\r\n  // @ts-ignore\r\n  const hasForcedParamsValues = ({ paramsForced, compareParams }) => {\r\n\r\n    // Iterates over the forced parameters and verifies that they exist in the URL and match their values\r\n    // Ej: { page: 1, page_size: 10 } === { page: 1, page_size: 10 } => true\r\n    const allParamsMatch = Object.entries(paramsForced).every(\r\n      ([key, value]) => compareParams[key] === value\r\n    );\r\n\r\n    return allParamsMatch;\r\n  };\r\n  \r\n  useEffect(() => {\r\n\r\n    const keysDefaultParams: string[] = Object.keys(defaultParams)\r\n    const keysForceParams: string[] = Object.keys(forceParams)\r\n    if(keysDefaultParams.length === 0 && keysForceParams.length === 0) return\r\n  \r\n\r\n    function handleStartingParams() {\r\n\r\n      const defaultParamsString  = transformParamsToURLSearch(defaultParams).toString()\r\n      const paramsUrl = getParams()\r\n      const paramsUrlString = transformParamsToURLSearch(paramsUrl).toString()\r\n      const forceParamsString = transformParamsToURLSearch(forceParams).toString()\r\n\r\n      console.log({defaultParamsString})\r\n\r\n      const isForcedParams: boolean = hasForcedParamsValues({ paramsForced: forceParams, compareParams: paramsUrl })\r\n\r\n      if (!isForcedParams) {\r\n\r\n        // In this case, the forced parameters take precedence over the default parameters and the parameters of the current URL (which could have been modified by the user, e.g., page_size=1000)\r\n\r\n        updateParams({ newParams: {\r\n          ...defaultParams,\r\n          ...forceParams\r\n        }})\r\n        return\r\n      }\r\n      // In this way it will be validated that the forced parameters keys and values are in the current URL\r\n      const isIncludesForcedParams = hasForcedParamsValues({ paramsForced: forceParamsString, compareParams: defaultParams })\r\n\r\n      if (keysDefaultParams.length > 0 && isIncludesForcedParams) {\r\n        if (defaultParamsString === paramsUrlString) return // this means that the URL already has the default parameters\r\n        updateParams({ newParams: defaultParams })\r\n      }\r\n\r\n    }\r\n    handleStartingParams()\r\n\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  }, [])\r\n\r\n  /**\r\n   * Convert a string value to its original type (number, boolean, array) according to TOTAL_PARAMS_PAGE\r\n   * @param value - Chain obtained from the URL\r\n   * @param key - Key of the parameter\r\n   */\r\n  const convertOriginalType = (value: string, key: string) => {\r\n    // Given that the parameters of a URL are recieved as strings, they are converted to their original type\r\n    if (typeof TOTAL_PARAMS_PAGE[key] === 'number') {\r\n      return parseInt(value)\r\n    } else if (typeof TOTAL_PARAMS_PAGE[key] === 'boolean') {\r\n      return value === 'true'\r\n    } else if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n      // The result will be a valid array represented in the URL ej: tags=tag1,tag2,tag3 to ['tag1', 'tag2', 'tag3'], useful to combine the values of the arrays with the new ones\r\n \r\n      if (arraySerialization === 'csv') {\r\n        return searchParams.getAll(key).join('').split(',')\r\n      } else if (arraySerialization === 'repeat') {\r\n    \r\n        console.log({SEARCH_PARAMS: searchParams.getAll(key)})\r\n        return searchParams.getAll(key)\r\n      } else if (arraySerialization === 'brackets') {\r\n        return searchParams.getAll(`${key}[]`)\r\n      }\r\n     \r\n     \r\n    }\r\n    // Note: dates are not converted as it is better to handle them directly in the component that receives them, using a library like < date-fns >\r\n    return value\r\n  }\r\n  \r\n    /**\r\n   * Gets the current parameters from the URL and converts them to their original type if desired\r\n   * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n   */\r\n    const getStringUrl = (key: string, paramsUrl: Record<string, unknown>) => {\r\n      const isKeyArray = Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n      if (isKeyArray) {\r\n\r\n        if (arraySerialization === 'brackets') {\r\n\r\n          const arrayUrl = searchParams.getAll(`${key}[]`)\r\n          const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayUrl }).toString()\r\n          // in this way the array of the URL is decoded to its original form ej: tags[]=tag1&tags[]=tag2&tags[]=tag3\r\n          const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n          return unencodeQuery\r\n        } else if (arraySerialization === 'csv') {\r\n          const arrayValue = searchParams.getAll(key)\r\n          const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n          const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n          return unencodeQuery\r\n        }\r\n        const arrayValue = searchParams.getAll(key)\r\n        const stringResult = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n        return stringResult\r\n      } else {\r\n   \r\n        return paramsUrl[key] as string\r\n      }\r\n     }\r\n     const getParamsObj = (searchParams: URLSearchParams): Record<string, string | string[]> => {\r\n      const paramsObj: Record<string, string | string[]> = {};\r\n      // @ts-ignore\r\n      for (const [key, value] of searchParams.entries()) {\r\n        if (key.endsWith('[]')) {\r\n          const bareKey = key.replace('[]', '');\r\n          if (paramsObj[bareKey]) {\r\n            (paramsObj[bareKey] as string[]).push(value);\r\n          } else {\r\n            paramsObj[bareKey] = [value];\r\n          }\r\n        } else {\r\n          // If the key already exists, it is a repeated parameter\r\n          if (paramsObj[key]) {\r\n            if (Array.isArray(paramsObj[key])) {\r\n              (paramsObj[key] as string[]).push(value);\r\n            } else {\r\n              paramsObj[key] = [paramsObj[key] as string, value];\r\n            }\r\n          } else {\r\n            paramsObj[key] = value;\r\n          }\r\n        }\r\n      }\r\n      return paramsObj;\r\n     }\r\n    // Optimization: While the parameters are not updated, the current parameters of the URL are not recalculated\r\n    const CURRENT_PARAMS_URL: Record<string, unknown> = useMemo(() => {\r\n\r\n      return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries())\r\n    }, [searchParams, arraySerialization])\r\n\r\n    /**\r\n      * Gets the current parameters from the URL and converts them to their original type if desired\r\n     * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n     * @returns - Returns the current parameters of the URL\r\n     */\r\n    const getParams = ({ convert = true } = {}): MergeParams<M, O> => {\r\n      // All the paramteres are extracted from the URL and converted into an object\r\n\r\n      const params = Object.keys(CURRENT_PARAMS_URL).reduce((acc, key) => {\r\n        if (Object.prototype.hasOwnProperty.call(TOTAL_PARAMS_PAGE, key)) {\r\n          const realKey = arraySerialization === 'brackets' ? key.replace('[]', '') : key\r\n          // @ts-ignore\r\n          acc[realKey] = convert === true\r\n            ? convertOriginalType(CURRENT_PARAMS_URL[key] as string, key)\r\n            :  getStringUrl(key, CURRENT_PARAMS_URL)\r\n        }\r\n        return acc\r\n      }, {})\r\n  \r\n      return params as MergeParams<M, O>\r\n    }\r\n  type keys = keyof MergeParams<M, O>\r\n  // Note: in this way the return of the getParam function is typed dynamically, thus having autocomplete in the IDE (eg: value.split(','))\r\n  type TagReturn<T extends boolean> = T extends true ? string[] : string;\r\n  /**\r\n    * Gets the value of a parameter from the URL and converts it to its original type if desired\r\n   * @param key - Key of the parameter\r\n   * @param options - Options to convert the value to its original type, default is true\r\n   * @returns - Returns the value of the parameter\r\n   */\r\n\r\n  const getParam = <T extends boolean>(key: keys, options?: { convert: T }): TagReturn<T>  => {\r\n\r\n    const keyStr = String(key)\r\n    // @ts-ignore\r\n    const value = options?.convert === true ? convertOriginalType(searchParams.get(keyStr), keyStr) : getStringUrl(keyStr,  CURRENT_PARAMS_URL)\r\n    return value as TagReturn<T> \r\n  }\r\n  \r\n  type OptionalParamsFiltered = Partial<O>\r\n\r\n  const calculateOmittedParameters = (newParams: Record<string, unknown | unknown[]>, keepParams: Record<string, boolean>) => {\r\n    // Calculate the ommited parameters, that is, the parameters that have not been sent in the request\r\n    const params = getParams()\r\n    // hasOw\r\n    // Note: it will be necessary to omit the parameters that are arrays because the idea is not to replace them but to add or remove some values\r\n    const newParamsWithoutArray = Object.entries(newParams).filter(([key,]) => !Array.isArray(TOTAL_PARAMS_PAGE[key]))\r\n    const result = Object.assign({\r\n      ...params,\r\n      ...Object.fromEntries(newParamsWithoutArray),\r\n      ...forceParams // the forced parameters will always be sent and will maintain their value\r\n    })\r\n    const paramsFiltered: OptionalParamsFiltered = Object.keys(result).reduce((acc, key) => {\r\n      // for default no parameters are omitted unless specified in the keepParams object\r\n      if (Object.prototype.hasOwnProperty.call(keepParams, key) && keepParams[key] === false) {\r\n        return acc\r\n      // Note: They array of parameters omitted by values (e.g., ['all', 'default']) are omitted since they are usually a default value that is not desired to be sent\r\n      } else if (!!result[key] !== false && !omitParamsByValues.includes(result[key])) {\r\n        // @ts-ignore\r\n        acc[key] = result[key]\r\n      }\r\n\r\n      return acc\r\n    }, {})\r\n\r\n    return {\r\n      ...mandatory,\r\n      ...paramsFiltered\r\n    } \r\n  }\r\n    // @ts-ignore\r\n  const sortParameters = (paramsFiltered) => {\r\n    // sort the parameters according to the structure so that it persists with each change in the URL, eg: localhost:3000/?page=1&page_size=10\r\n    // Note: this visibly improves the user experience\r\n    const orderedParams = PARAM_ORDER.reduce((acc, key) => {\r\n      if (Object.prototype.hasOwnProperty.call(paramsFiltered, key)) {\r\n          // @ts-ignore\r\n        acc[key] = paramsFiltered[key]\r\n      }\r\n\r\n      return acc\r\n    }, {})\r\n    return orderedParams\r\n  }\r\n\r\n  const mandatoryParameters = () => {\r\n    // Note: in case there are arrays in the URL, they are converted to their original form ej: tags=['tag1', 'tag2'] otherwise the parameters are extracted without converting to optimize performance\r\n    const isNecessaryConvert: boolean = ARRAY_KEYS.length > 0 ? true : false\r\n    const totalParametros: Record<string, unknown>  = getParams({ convert: isNecessaryConvert })\r\n\r\n    const paramsUrlFound: Record<string, boolean> = Object.keys(totalParametros).reduce(\r\n      (acc, key) => {\r\n        if (Object.prototype.hasOwnProperty.call(mandatory, key)) {\r\n          // @ts-ignore\r\n          acc[key] = totalParametros[key]\r\n        }\r\n        return acc\r\n      },\r\n      {}\r\n    )\r\n\r\n    return paramsUrlFound\r\n  }\r\n  /**\r\n   clears the parameters of the URL, keeping the mandatory parameters\r\n   * @param keepMandatoryParams - If true, the mandatory parameters are kept in the URL\r\n   */\r\n\r\n  const clearParams = ({ keepMandatoryParams = true } = {}): void => {\r\n    // for default, the mandatory parameters are not cleared since the current pagination would be lost\r\n    const paramsTransformed = transformParamsToURLSearch(\r\n      {\r\n        ...mandatory,\r\n     \r\n         ...(keepMandatoryParams && {\r\n          ...mandatoryParameters()\r\n        }),\r\n        ...forceParams \r\n      }\r\n    )\r\n    setSearchParams(paramsTransformed) \r\n  }\r\n\r\n  // transforms the keys to boolean to know which parameters to keep\r\n  type KeepParamsTransformedValuesBoolean = Partial<Record<keyof typeof TOTAL_PARAMS_PAGE, boolean>>\r\n  type NewParams = Partial<typeof TOTAL_PARAMS_PAGE> \r\n  type KeepParams = KeepParamsTransformedValuesBoolean\r\n  /**\r\n   Merges the new parameters with the current ones, omits the parameters that are not sent and sorts them according to the structure\r\n   * @param newParams - New parameters to be sent in the URL\r\n   * @param keepParams - Parameters to keep in the URL, default is true\r\n   */\r\n  const updateParams = ({ newParams = {} as NewParams, keepParams = {} as KeepParams } = {}) => {\r\n\r\n    if (\r\n      Object.keys(newParams).length === 0 &&\r\n      Object.keys(keepParams).length === 0\r\n    ) {\r\n      clearParams()\r\n      return\r\n    }\r\n    // @ts-ignore\r\n    const finallyParamters = calculateOmittedParameters(newParams, keepParams)\r\n\r\n    const convertedArrayValues = appendArrayValues(finallyParamters, newParams)\r\n\r\n    const paramsSorted = sortParameters(convertedArrayValues)\r\n\r\n    setSearchParams(transformParamsToURLSearch(paramsSorted))\r\n\r\n  }\r\n\r\n  /**\r\n   * @param paramName - Name of the parameter to subscribe to\r\n   * @param callbacks - Callbacks to be executed when the parameter changes\r\n   * @returns - Returns the function to unsubscribe\r\n   */\r\n    const onChange = useCallback( (paramName: keys, callbacks: Array<() => void>) => {\r\n      const paramNameStr = String(paramName)\r\n      // replace the previous callbacks with the new ones so as not to accumulate callbacks\r\n      subscriptionsRef.current[paramNameStr] = callbacks;\r\n    }, [])\r\n  \r\n    // each time searchParams changes, we notify the subscribers\r\n    useEffect(() => {\r\n\r\n      for (const [key, value] of Object.entries(subscriptionsRef.current)) {\r\n\r\n        const newValue = CURRENT_PARAMS_URL[key] ?? null \r\n        const oldValue = previousParamsRef.current[key] ?? null\r\n        if (newValue !== oldValue) {\r\n          \r\n          for (const callback of value) {\r\n            callback()\r\n\r\n          }\r\n        }\r\n        // once the callback is executed, the previous value is updated to ensure that the next time the value changes, the callback is executed\r\n        previousParamsRef.current[key] = newValue\r\n      }\r\n\r\n      \r\n    }, [CURRENT_PARAMS_URL])\r\n  return {\r\n    searchParams,\r\n    updateParams,\r\n    clearParams,\r\n    getParams,\r\n    getParam,\r\n    onChange\r\n  }\r\n}\r\n\r\n"],"names":["useMagicSearchParams","_ref","mandatory","_ref$mandatory","_ref$optional","optional","_ref$defaultParams","defaultParams","_ref$arraySerializati","arraySerialization","_ref$forceParams","forceParams","_ref$omitParamsByValu","omitParamsByValues","_useSearchParams","useSearchParams","searchParams","setSearchParams","subscriptionsRef","useRef","previousParamsRef","TOTAL_PARAMS_PAGE","useMemo","_extends","PARAM_ORDER","Array","from","Object","keys","ARRAY_KEYS","filter","key","isArray","appendArrayValues","finallyParams","newParams","updatedParams","length","forEach","currentValues","raw","get","split","map","v","trim","Boolean","urlParams","getAll","console","log","REPEAT","BRACKETS","_searchParams$get","undefined","incoming","combined","includes","concat","CONBINED_STRING","Set","transformParamsToURLSearch","params","PARAMS_RECIBIDOS_TRANSFORM","newParam","URLSearchParams","paramsKeys","_i","_paramsKeys","arrayValue","csvValue","join","set","_iterator","_createForOfIteratorHelperLoose","_step","done","item","value","append","_iterator2","_step2","hasForcedParamsValues","_ref2","paramsForced","compareParams","allParamsMatch","entries","every","_ref3","useEffect","keysDefaultParams","keysForceParams","handleStartingParams","defaultParamsString","toString","paramsUrl","getParams","paramsUrlString","forceParamsString","isForcedParams","updateParams","isIncludesForcedParams","convertOriginalType","parseInt","SEARCH_PARAMS","getStringUrl","isKeyArray","_transformParamsToURL3","_transformParamsToURL","arrayUrl","encodedQueryArray","unencodeQuery","decodeURIComponent","_transformParamsToURL2","stringResult","getParamsObj","paramsObj","_iterator3","_step3","_step3$value","endsWith","bareKey","replace","push","CURRENT_PARAMS_URL","fromEntries","_temp","_ref4$convert","_ref4","convert","reduce","acc","prototype","hasOwnProperty","call","realKey","getParam","options","keyStr","String","calculateOmittedParameters","keepParams","newParamsWithoutArray","_ref5","result","assign","paramsFiltered","sortParameters","orderedParams","mandatoryParameters","isNecessaryConvert","totalParametros","paramsUrlFound","clearParams","_temp2","_ref6$keepMandatoryPa","_ref6","keepMandatoryParams","paramsTransformed","_temp3","_ref7$newParams","_ref7","_ref7$keepParams","finallyParamters","convertedArrayValues","paramsSorted","onChange","useCallback","paramName","callbacks","paramNameStr","current","_i2","_Object$entries","_CURRENT_PARAMS_URL$k","_previousParamsRef$cu","_Object$entries$_i","newValue","oldValue","_iterator4","_step4","callback"],"mappings":"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"}

package/dist/react-magic-search-params.cjs.production.min.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var r=require("react-router-dom"),e=require("react");function t(r,e){(null==e||e>r.length)&&(e=r.length);for(var t=0,n=Array(e);t<e;t++)n[t]=r[t];return n}function n(r,e){var n="undefined"!=typeof Symbol&&r[Symbol.iterator]||r["@@iterator"];if(n)return(n=n.call(r)).next.bind(n);if(Array.isArray(r)||(n=function(r,e){if(r){if("string"==typeof r)return t(r,e);var n={}.toString.call(r).slice(8,-1);return"Object"===n&&r.constructor&&(n=r.constructor.name),"Map"===n||"Set"===n?Array.from(r):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?t(r,e):void 0}}(r))||e&&r&&"number"==typeof r.length){n&&(r=n);var a=0;return function(){return a>=r.length?{done:!0}:{done:!1,value:r[a++]}}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function a(){return(a=Object.assign?Object.assign.bind():function(r){for(var e=1;e<arguments.length;e++){var t=arguments[e];for(var n in t)({}).hasOwnProperty.call(t,n)&&(r[n]=t[n])}return r}).apply(null,arguments)}exports.useMagicSearchParams=function(t){var o=t.mandatory,c=void 0===o?{}:o,i=t.optional,l=void 0===i?{}:i,s=t.defaultParams,u=void 0===s?{}:s,f=t.arraySerialization,v=void 0===f?"csv":f,g=t.forceParams,m=void 0===g?{}:g,d=t.omitParamsByValues,y=void 0===d?[]:d,p=r.useSearchParams(),b=p[0],A=p[1],h=e.useRef({}),O=e.useRef({}),P=e.useMemo((function(){return a({},c,l)}),[c,l]),j=e.useMemo((function(){return Array.from(Object.keys(P))}),[P]),S=e.useMemo((function(){return Object.keys(P).filter((function(r){return Array.isArray(P[r])}))}),[P]),k=function(r){console.log({PARAMS_RECIBIDOS_TRANSFORM:r});for(var e=new URLSearchParams,t=0,a=Object.keys(r);t<a.length;t++){var o=a[t];if(Array.isArray(P[o])){var c=r[o];switch(console.log({arrayValue:c}),v){case"csv":var i=c.join(",");e.set(o,i);break;case"repeat":for(var l,s=n(c);!(l=s()).done;){var u=l.value;console.log({item:u}),e.append(o,u)}break;case"brackets":for(var f,g=n(c);!(f=g()).done;)e.append(o+"[]",f.value);break;default:var m=c.join(",");e.set(o,m)}}else e.set(o,r[o])}return console.log({FINAL:e.toString()}),e},w=function(r){var e=r.compareParams;return Object.entries(r.paramsForced).every((function(r){return e[r[0]]===r[1]}))};e.useEffect((function(){var r=Object.keys(u),e=Object.keys(m);0===r.length&&0===e.length||function(){var e=k(u).toString(),t=M(),n=k(t).toString(),o=k(m).toString();if(console.log({defaultParamsString:e}),w({paramsForced:m,compareParams:t})){var c=w({paramsForced:o,compareParams:u});if(r.length>0&&c){if(e===n)return;B({newParams:u})}}else B({newParams:a({},u,m)})}()}),[]);var R=function(r,e){if("number"==typeof P[e])return parseInt(r);if("boolean"==typeof P[e])return"true"===r;if(Array.isArray(P[e])){if("csv"===v)return b.getAll(e).join("").split(",");if("repeat"===v)return console.log({SEARCH_PARAMS:b.getAll(e)}),b.getAll(e);if("brackets"===v)return b.getAll(e+"[]")}return r},E=function(r,e){if(Array.isArray(P[r])){var t;if("brackets"===v){var n,a=b.getAll(r+"[]"),o=k((n={},n[r]=a,n)).toString();return decodeURIComponent(o)}if("csv"===v){var c,i=b.getAll(r),l=k((c={},c[r]=i,c)).toString();return decodeURIComponent(l)}var s=b.getAll(r);return k((t={},t[r]=s,t)).toString()}return e[r]},I=e.useMemo((function(){return"brackets"===v?function(r){for(var e,t={},a=n(r.entries());!(e=a()).done;){var o=e.value,c=o[0],i=o[1];if(c.endsWith("[]")){var l=c.replace("[]","");t[l]?t[l].push(i):t[l]=[i]}else t[c]?Array.isArray(t[c])?t[c].push(i):t[c]=[t[c],i]:t[c]=i}return t}(b):Object.fromEntries(b.entries())}),[b,v]),M=function(r){var e=(void 0===r?{}:r).convert,t=void 0===e||e;return Object.keys(I).reduce((function(r,e){return Object.prototype.hasOwnProperty.call(P,e)&&(r["brackets"===v?e.replace("[]",""):e]=!0===t?R(I[e],e):E(e,I)),r}),{})},C=function(r){var e,t=(void 0===r?{}:r).keepMandatoryParams,n=k(a({},c,(void 0===t||t)&&a({},(e=M({convert:S.length>0}),Object.keys(e).reduce((function(r,t){return Object.prototype.hasOwnProperty.call(c,t)&&(r[t]=e[t]),r}),{}))),m));A(n)},B=function(r){var e=void 0===r?{}:r,t=e.newParams,n=void 0===t?{}:t,o=e.keepParams,i=void 0===o?{}:o;if(0!==Object.keys(n).length||0!==Object.keys(i).length){var l,s=function(r,e){var t=a({},r);return 0===S.length||(S.forEach((function(r){var n=[];switch(v){case"csv":n=(b.get(r)||"").split(",").map((function(r){return r.trim()})).filter(Boolean);break;case"repeat":var a=b.getAll(r);n=a.length>0?a:[],console.log({REPEAT:n});break;case"brackets":var o=b.getAll(r+"[]");n=o.length>0?o:[],console.log({BRACKETS:o});break;default:var c;n=(null!=(c=b.get(r))?c:"").split(",").map((function(r){return r.trim()})).filter(Boolean)}if(void 0!==e[r]){var i=e[r],l=[];"string"==typeof i?(l=n.includes(i)?n.filter((function(r){return r!==i})):[].concat(n,[i]),console.log({currentValues:n}),console.log({incoming:i}),console.log({CONBINED_STRING:l})):Array.isArray(i)?(l=Array.from(new Set([].concat(i))),console.log({incoming:i}),console.log({combined:l})):l=n,t[r]=l}})),console.log({updatedParams:t})),t}(function(r,e){var t=M(),n=Object.entries(r).filter((function(r){return!Array.isArray(P[r[0]])})),o=Object.assign(a({},t,Object.fromEntries(n),m)),i=Object.keys(o).reduce((function(r,t){return Object.prototype.hasOwnProperty.call(e,t)&&!1===e[t]||0==!!o[t]||y.includes(o[t])||(r[t]=o[t]),r}),{});return a({},c,i)}(n,i),n),u=(l=s,j.reduce((function(r,e){return Object.prototype.hasOwnProperty.call(l,e)&&(r[e]=l[e]),r}),{}));A(k(u))}else C()},_=e.useCallback((function(r,e){var t=String(r);h.current[t]=e}),[]);return e.useEffect((function(){for(var r=0,e=Object.entries(h.current);r<e.length;r++){var t,a,o=e[r],c=o[0],i=o[1],l=null!=(t=I[c])?t:null;if(l!==(null!=(a=O.current[c])?a:null))for(var s,u=n(i);!(s=u()).done;){var f=s.value;console.log(i),f()}O.current[c]=l}}),[I]),{searchParams:b,updateParams:B,clearParams:C,getParams:M,getParam:function(r,e){var t=String(r);return!0===(null==e?void 0:e.convert)?R(b.get(t),t):E(t,I)},onChange:_}};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var r=require("react-router-dom"),e=require("react");function t(r,e){(null==e||e>r.length)&&(e=r.length);for(var t=0,n=Array(e);t<e;t++)n[t]=r[t];return n}function n(r,e){var n="undefined"!=typeof Symbol&&r[Symbol.iterator]||r["@@iterator"];if(n)return(n=n.call(r)).next.bind(n);if(Array.isArray(r)||(n=function(r,e){if(r){if("string"==typeof r)return t(r,e);var n={}.toString.call(r).slice(8,-1);return"Object"===n&&r.constructor&&(n=r.constructor.name),"Map"===n||"Set"===n?Array.from(r):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?t(r,e):void 0}}(r))||e&&r&&"number"==typeof r.length){n&&(r=n);var a=0;return function(){return a>=r.length?{done:!0}:{done:!1,value:r[a++]}}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function a(){return(a=Object.assign?Object.assign.bind():function(r){for(var e=1;e<arguments.length;e++){var t=arguments[e];for(var n in t)({}).hasOwnProperty.call(t,n)&&(r[n]=t[n])}return r}).apply(null,arguments)}exports.useMagicSearchParams=function(t){var o=t.mandatory,i=void 0===o?{}:o,c=t.optional,u=void 0===c?{}:c,l=t.defaultParams,s=void 0===l?{}:l,f=t.arraySerialization,v=void 0===f?"csv":f,g=t.forceParams,m=void 0===g?{}:g,y=t.omitParamsByValues,d=void 0===y?[]:y,p=r.useSearchParams(),b=p[0],A=p[1],h=e.useRef({}),O=e.useRef({}),P=e.useMemo((function(){return a({},i,u)}),[i,u]),j=e.useMemo((function(){return Array.from(Object.keys(P))}),[P]),S=e.useMemo((function(){return Object.keys(P).filter((function(r){return Array.isArray(P[r])}))}),[P]),k=function(r){console.log({PARAMS_RECIBIDOS_TRANSFORM:r});for(var e=new URLSearchParams,t=0,a=Object.keys(r);t<a.length;t++){var o=a[t];if(Array.isArray(P[o])){var i=r[o];switch(console.log({arrayValue:i}),v){case"csv":var c=i.join(",");e.set(o,c);break;case"repeat":for(var u,l=n(i);!(u=l()).done;){var s=u.value;console.log({item:s}),e.append(o,s)}break;case"brackets":for(var f,g=n(i);!(f=g()).done;)e.append(o+"[]",f.value);break;default:var m=i.join(",");e.set(o,m)}}else e.set(o,r[o])}return e},w=function(r){var e=r.compareParams;return Object.entries(r.paramsForced).every((function(r){return e[r[0]]===r[1]}))};e.useEffect((function(){var r=Object.keys(s),e=Object.keys(m);0===r.length&&0===e.length||function(){var e=k(s).toString(),t=I(),n=k(t).toString(),o=k(m).toString();if(console.log({defaultParamsString:e}),w({paramsForced:m,compareParams:t})){var i=w({paramsForced:o,compareParams:s});if(r.length>0&&i){if(e===n)return;B({newParams:s})}}else B({newParams:a({},s,m)})}()}),[]);var R=function(r,e){if("number"==typeof P[e])return parseInt(r);if("boolean"==typeof P[e])return"true"===r;if(Array.isArray(P[e])){if("csv"===v)return b.getAll(e).join("").split(",");if("repeat"===v)return console.log({SEARCH_PARAMS:b.getAll(e)}),b.getAll(e);if("brackets"===v)return b.getAll(e+"[]")}return r},E=function(r,e){if(Array.isArray(P[r])){var t;if("brackets"===v){var n,a=b.getAll(r+"[]"),o=k((n={},n[r]=a,n)).toString();return decodeURIComponent(o)}if("csv"===v){var i,c=b.getAll(r),u=k((i={},i[r]=c,i)).toString();return decodeURIComponent(u)}var l=b.getAll(r);return k((t={},t[r]=l,t)).toString()}return e[r]},M=e.useMemo((function(){return"brackets"===v?function(r){for(var e,t={},a=n(r.entries());!(e=a()).done;){var o=e.value,i=o[0],c=o[1];if(i.endsWith("[]")){var u=i.replace("[]","");t[u]?t[u].push(c):t[u]=[c]}else t[i]?Array.isArray(t[i])?t[i].push(c):t[i]=[t[i],c]:t[i]=c}return t}(b):Object.fromEntries(b.entries())}),[b,v]),I=function(r){var e=(void 0===r?{}:r).convert,t=void 0===e||e;return Object.keys(M).reduce((function(r,e){return Object.prototype.hasOwnProperty.call(P,e)&&(r["brackets"===v?e.replace("[]",""):e]=!0===t?R(M[e],e):E(e,M)),r}),{})},C=function(r){var e,t=(void 0===r?{}:r).keepMandatoryParams,n=k(a({},i,(void 0===t||t)&&a({},(e=I({convert:S.length>0}),Object.keys(e).reduce((function(r,t){return Object.prototype.hasOwnProperty.call(i,t)&&(r[t]=e[t]),r}),{}))),m));A(n)},B=function(r){var e=void 0===r?{}:r,t=e.newParams,n=void 0===t?{}:t,o=e.keepParams,c=void 0===o?{}:o;if(0!==Object.keys(n).length||0!==Object.keys(c).length){var u,l=function(r,e){var t=a({},r);return 0===S.length||S.forEach((function(r){var n=[];switch(v){case"csv":n=(b.get(r)||"").split(",").map((function(r){return r.trim()})).filter(Boolean);break;case"repeat":var a=b.getAll(r);n=a.length>0?a:[],console.log({REPEAT:n});break;case"brackets":var o=b.getAll(r+"[]");n=o.length>0?o:[],console.log({BRACKETS:o});break;default:var i;n=(null!=(i=b.get(r))?i:"").split(",").map((function(r){return r.trim()})).filter(Boolean)}if(void 0!==e[r]){var c=e[r],u=[];"string"==typeof c?(u=n.includes(c)?n.filter((function(r){return r!==c})):[].concat(n,[c]),console.log({currentValues:n}),console.log({incoming:c}),console.log({CONBINED_STRING:u})):Array.isArray(c)?(u=Array.from(new Set([].concat(c))),console.log({incoming:c}),console.log({combined:u})):u=n,t[r]=u}})),t}(function(r,e){var t=I(),n=Object.entries(r).filter((function(r){return!Array.isArray(P[r[0]])})),o=Object.assign(a({},t,Object.fromEntries(n),m)),c=Object.keys(o).reduce((function(r,t){return Object.prototype.hasOwnProperty.call(e,t)&&!1===e[t]||0==!!o[t]||d.includes(o[t])||(r[t]=o[t]),r}),{});return a({},i,c)}(n,c),n),s=(u=l,j.reduce((function(r,e){return Object.prototype.hasOwnProperty.call(u,e)&&(r[e]=u[e]),r}),{}));A(k(s))}else C()},_=e.useCallback((function(r,e){var t=String(r);h.current[t]=e}),[]);return e.useEffect((function(){for(var r=0,e=Object.entries(h.current);r<e.length;r++){var t,a,o=e[r],i=o[0],c=null!=(t=M[i])?t:null;if(c!==(null!=(a=O.current[i])?a:null))for(var u,l=n(o[1]);!(u=l()).done;)(0,u.value)();O.current[i]=c}}),[M]),{searchParams:b,updateParams:B,clearParams:C,getParams:I,getParam:function(r,e){var t=String(r);return!0===(null==e?void 0:e.convert)?R(b.get(t),t):E(t,M)},onChange:_}};
 //# sourceMappingURL=react-magic-search-params.cjs.production.min.js.map

package/dist/react-magic-search-params.cjs.production.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-magic-search-params.cjs.production.min.js","sources":["../src/useMagicSearchParams.ts"],"sourcesContent":["import { useSearchParams } from 'react-router-dom'\r\nimport { useMemo, useEffect, useRef, useCallback } from 'react'\r\n\r\n\r\n// Custom hook with advanced techniques to handle search parameters for any pagination\r\n\r\ntype CommonParams = {\r\n  page?: number\r\n  page_size?: number\r\n}\r\n/*\r\nMaps all properties of M (mandatory) as required\r\nand all properties of O (optional) as optional. \r\n*/\r\ntype MergeParams<M, O> = {\r\n  [K in keyof M]: M[K]\r\n} & {\r\n  [K in keyof O]?: O[K]\r\n}\r\n/**\r\n * Interface for the configuration object that the hook receives \r\n */\r\nexport interface UseMagicSearchParamsOptions<\r\n  M extends Record<string, unknown>,\r\n  O extends Record<string, unknown>\r\n> {\r\n  mandatory: M \r\n  optional?: O\r\n  defaultParams?: Partial<MergeParams<M, O>>\r\n  forceParams?: Partial<MergeParams<M, O>> // transform all to partial to avoid errors\r\n  arraySerialization?: 'csv' | 'repeat' | 'brackets' // technical to serialize arrays in the URL\r\n  omitParamsByValues?: Array<'all' | 'default' | 'unknown' | 'none' | 'void '> \r\n}\r\n\r\n/** \r\nGeneric hook to handle search parameters in the URL\r\n@param mandatory - Mandatory parameters (e.g., page=1, page_size=10, etc.)\r\n@param optional - Optional parameters (e.g., order, search, etc.)\r\n@param defaultParams - Default parameters sent in the URL on initialization\r\n@param forceParams - Parameters forced into the URL regardless of user input\r\n@param omitParamsByValues - Parameters omitted if they have specific values \r\n*/\r\nexport const useMagicSearchParams = <\r\n  M extends Record<string, unknown> & CommonParams,\r\n  O extends Record<string, unknown>,\r\n>({\r\n  mandatory = {} as M,\r\n  optional = {} as O,\r\n  defaultParams = {} as Partial<MergeParams<M, O>>,\r\n  arraySerialization = 'csv',\r\n  forceParams = {} as  {} as Partial<MergeParams<M, O>>,\r\n  omitParamsByValues = [] as Array<'all' | 'default' | 'unknown' | 'none' | 'void '>\r\n}: UseMagicSearchParamsOptions<M, O>)=> {\r\n\r\n\r\n  const [searchParams, setSearchParams] = useSearchParams() \r\n    // Ref to store subscriptions: { paramName: [callback1, callback2, ...] }\r\n  const subscriptionsRef = useRef<Record<string, Array<() => unknown>>>({}); \r\n  const previousParamsRef = useRef<Record<string, unknown>>({})\r\n\r\n  const TOTAL_PARAMS_PAGE: MergeParams<M, O> = useMemo(() => {\r\n    return { ...mandatory, ...optional };\r\n  }, [mandatory, optional]);\r\n\r\n  const PARAM_ORDER = useMemo(() => {\r\n    return Array.from(Object.keys(TOTAL_PARAMS_PAGE))\r\n  }, [TOTAL_PARAMS_PAGE])\r\n\r\n  // we get the keys that are arrays according to TOTAL_PARAMS_PAGE since these require special treatment in the URL due to serialization mode\r\n  const ARRAY_KEYS = useMemo(() => {\r\n    return Object.keys(TOTAL_PARAMS_PAGE).filter(\r\n      (key) => Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n    );\r\n  }, [TOTAL_PARAMS_PAGE])\r\n\r\n  const appendArrayValues = (\r\n    finallyParams: Record<string, unknown>,\r\n    newParams: Record<string, string | string[] | unknown>\r\n  ): Record<string, unknown> => {\r\n \r\n    // Note: We cannot modify the object of the final parameters directly, as immutability must be maintained\r\n    const updatedParams = { ...finallyParams };\r\n  \r\n\r\n    if (ARRAY_KEYS.length === 0) return updatedParams;\r\n  \r\n    ARRAY_KEYS.forEach((key) => {\r\n      // We use the current values directly from searchParams (source of truth)\r\n      // This avoids depending on finallyParams in which the arrays have been omitted\r\n      let currentValues = []; \r\n      switch (arraySerialization) {\r\n        case 'csv': {\r\n          const raw = searchParams.get(key) || '';\r\n          // For csv we expect \"value1,value2,...\" (no prefix)\r\n          currentValues = raw.split(',')\r\n            .map((v) => v.trim())\r\n            .filter(Boolean) as Array<string>\r\n          break;\r\n        }\r\n        case 'repeat': {\r\n          // Here we get all ocurrences of key\r\n          const urlParams = searchParams.getAll(key) as Array<string>\r\n          currentValues = urlParams.length > 0 ? urlParams : []\r\n          \r\n          console.log({REPEAT: currentValues})\r\n          break;\r\n        }\r\n        case 'brackets': {\r\n           // Build URLSearchParams from current parameters (to ensure no serialized values are taken previously)\r\n            const urlParams = searchParams.getAll(`${key}[]`) as Array<string>\r\n            currentValues = urlParams.length > 0 ? urlParams : []\r\n            console.log({BRACKETS: urlParams})\r\n        \r\n    \r\n            break;\r\n        }\r\n        default: {\r\n          // Mode by default works as csv\r\n          const raw = searchParams.get(key) ?? '';\r\n          currentValues = raw.split(',')\r\n            .map((v) => v.trim())\r\n            .filter(Boolean);\r\n          }\r\n        break; \r\n      }\r\n      // Update array values with new ones\r\n    \r\n      if (newParams[key] !== undefined) {\r\n        const incoming = newParams[key];\r\n        let combined: string[] = []\r\n        if (typeof incoming === 'string') {\r\n          // If it is a string, it is toggled (add/remove)\r\n          combined = currentValues.includes(incoming)\r\n            ? currentValues.filter((v) => v !== incoming)\r\n            : [...currentValues, incoming];\r\n          console.log({currentValues})\r\n            console.log({incoming})\r\n          console.log({CONBINED_STRING: combined})\r\n        } else if (Array.isArray(incoming)) {\r\n          // if an array is passed, repeated values are merged into a single value\r\n          // Note: Set is used to remove duplicates\r\n          combined = Array.from(new Set([ ...incoming]));\r\n          console.log({incoming})\r\n          console.log({combined})\r\n        } else {\r\n       \r\n          combined = currentValues;\r\n        }\r\n\r\n        updatedParams[key] = combined\r\n\r\n      }\r\n    });\r\n    console.log({updatedParams})\r\n    return updatedParams\r\n  };\r\n\r\n  const transformParamsToURLSearch = (params: Record<string, unknown>): URLSearchParams => {\r\n    console.log({PARAMS_RECIBIDOS_TRANSFORM: params})\r\n\r\n    const newParam: URLSearchParams = new URLSearchParams()\r\n\r\n    const paramsKeys = Object.keys(params)\r\n\r\n    for (const key of paramsKeys) {\r\n      if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n        const arrayValue = params[key] as unknown[]\r\n        console.log({arrayValue})\r\n        switch (arraySerialization) {\r\n          case 'csv': {\r\n            const csvValue = arrayValue.join(',')\r\n            // set ensure that the previous value is replaced\r\n            newParam.set(key, csvValue)\r\n            break\r\n          } case 'repeat': {\r\n      \r\n            for (const item of arrayValue) {\r\n              console.log({item})\r\n              // add new value to the key, instead of replacing it\r\n              newParam.append(key, item as string)\r\n   \r\n            }\r\n            break\r\n          } case 'brackets': {\r\n            for (const item of arrayValue) {\r\n              newParam.append(`${key}[]`, item as string)\r\n            }\r\n            break\r\n          } default: {\r\n            const csvValue = arrayValue.join(',')\r\n            newParam.set(key, csvValue)\r\n          }\r\n        }\r\n      } else {\r\n        newParam.set(key, params[key] as string)\r\n      }\r\n    }\r\n    console.log({FINAL: newParam.toString()})\r\n    return newParam\r\n  }\r\n  // @ts-ignore\r\n  const hasForcedParamsValues = ({ paramsForced, compareParams }) => {\r\n\r\n    // Iterates over the forced parameters and verifies that they exist in the URL and match their values\r\n    // Ej: { page: 1, page_size: 10 } === { page: 1, page_size: 10 } => true\r\n    const allParamsMatch = Object.entries(paramsForced).every(\r\n      ([key, value]) => compareParams[key] === value\r\n    );\r\n\r\n    return allParamsMatch;\r\n  };\r\n  \r\n  useEffect(() => {\r\n\r\n    const keysDefaultParams: string[] = Object.keys(defaultParams)\r\n    const keysForceParams: string[] = Object.keys(forceParams)\r\n    if(keysDefaultParams.length === 0 && keysForceParams.length === 0) return\r\n  \r\n\r\n    function handleStartingParams() {\r\n\r\n      const defaultParamsString  = transformParamsToURLSearch(defaultParams).toString()\r\n      const paramsUrl = getParams()\r\n      const paramsUrlString = transformParamsToURLSearch(paramsUrl).toString()\r\n      const forceParamsString = transformParamsToURLSearch(forceParams).toString()\r\n\r\n      console.log({defaultParamsString})\r\n\r\n      const isForcedParams: boolean = hasForcedParamsValues({ paramsForced: forceParams, compareParams: paramsUrl })\r\n\r\n      if (!isForcedParams) {\r\n\r\n        // In this case, the forced parameters take precedence over the default parameters and the parameters of the current URL (which could have been modified by the user, e.g., page_size=1000)\r\n\r\n        updateParams({ newParams: {\r\n          ...defaultParams,\r\n          ...forceParams\r\n        }})\r\n        return\r\n      }\r\n      // In this way it will be validated that the forced parameters keys and values are in the current URL\r\n      const isIncludesForcedParams = hasForcedParamsValues({ paramsForced: forceParamsString, compareParams: defaultParams })\r\n\r\n      if (keysDefaultParams.length > 0 && isIncludesForcedParams) {\r\n        if (defaultParamsString === paramsUrlString) return // this means that the URL already has the default parameters\r\n        updateParams({ newParams: defaultParams })\r\n      }\r\n\r\n    }\r\n    handleStartingParams()\r\n\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  }, [])\r\n\r\n  /**\r\n   * Convert a string value to its original type (number, boolean, array) according to TOTAL_PARAMS_PAGE\r\n   * @param value - Chain obtained from the URL\r\n   * @param key - Key of the parameter\r\n   */\r\n  const convertOriginalType = (value: string, key: string) => {\r\n    // Given that the parameters of a URL are recieved as strings, they are converted to their original type\r\n    if (typeof TOTAL_PARAMS_PAGE[key] === 'number') {\r\n      return parseInt(value)\r\n    } else if (typeof TOTAL_PARAMS_PAGE[key] === 'boolean') {\r\n      return value === 'true'\r\n    } else if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n      // The result will be a valid array represented in the URL ej: tags=tag1,tag2,tag3 to ['tag1', 'tag2', 'tag3'], useful to combine the values of the arrays with the new ones\r\n \r\n      if (arraySerialization === 'csv') {\r\n        return searchParams.getAll(key).join('').split(',')\r\n      } else if (arraySerialization === 'repeat') {\r\n    \r\n        console.log({SEARCH_PARAMS: searchParams.getAll(key)})\r\n        return searchParams.getAll(key)\r\n      } else if (arraySerialization === 'brackets') {\r\n        return searchParams.getAll(`${key}[]`)\r\n      }\r\n     \r\n     \r\n    }\r\n    // Note: dates are not converted as it is better to handle them directly in the component that receives them, using a library like < date-fns >\r\n    return value\r\n  }\r\n  \r\n    /**\r\n   * Gets the current parameters from the URL and converts them to their original type if desired\r\n   * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n   */\r\n    const getStringUrl = (key: string, paramsUrl: Record<string, unknown>) => {\r\n      const isKeyArray = Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n      if (isKeyArray) {\r\n\r\n        if (arraySerialization === 'brackets') {\r\n\r\n          const arrayUrl = searchParams.getAll(`${key}[]`)\r\n          const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayUrl }).toString()\r\n          // in this way the array of the URL is decoded to its original form ej: tags[]=tag1&tags[]=tag2&tags[]=tag3\r\n          const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n          return unencodeQuery\r\n        } else if (arraySerialization === 'csv') {\r\n          const arrayValue = searchParams.getAll(key)\r\n          const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n          const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n          return unencodeQuery\r\n        }\r\n        const arrayValue = searchParams.getAll(key)\r\n        const stringResult = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n        return stringResult\r\n      } else {\r\n   \r\n        return paramsUrl[key] as string\r\n      }\r\n     }\r\n     const getParamsObj = (searchParams: URLSearchParams): Record<string, string | string[]> => {\r\n      const paramsObj: Record<string, string | string[]> = {};\r\n      // @ts-ignore\r\n      for (const [key, value] of searchParams.entries()) {\r\n        if (key.endsWith('[]')) {\r\n          const bareKey = key.replace('[]', '');\r\n          if (paramsObj[bareKey]) {\r\n            (paramsObj[bareKey] as string[]).push(value);\r\n          } else {\r\n            paramsObj[bareKey] = [value];\r\n          }\r\n        } else {\r\n          // If the key already exists, it is a repeated parameter\r\n          if (paramsObj[key]) {\r\n            if (Array.isArray(paramsObj[key])) {\r\n              (paramsObj[key] as string[]).push(value);\r\n            } else {\r\n              paramsObj[key] = [paramsObj[key] as string, value];\r\n            }\r\n          } else {\r\n            paramsObj[key] = value;\r\n          }\r\n        }\r\n      }\r\n      return paramsObj;\r\n     }\r\n    // Optimization: While the parameters are not updated, the current parameters of the URL are not recalculated\r\n    const CURRENT_PARAMS_URL: Record<string, unknown> = useMemo(() => {\r\n\r\n      return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries())\r\n    }, [searchParams, arraySerialization])\r\n\r\n    const getParams = ({ convert = true } = {}): MergeParams<M, O> => {\r\n      // All the paramteres are extracted from the URL and converted into an object\r\n\r\n      const params = Object.keys(CURRENT_PARAMS_URL).reduce((acc, key) => {\r\n        if (Object.prototype.hasOwnProperty.call(TOTAL_PARAMS_PAGE, key)) {\r\n          const realKey = arraySerialization === 'brackets' ? key.replace('[]', '') : key\r\n          // @ts-ignore\r\n          acc[realKey] = convert === true\r\n            ? convertOriginalType(CURRENT_PARAMS_URL[key] as string, key)\r\n            :  getStringUrl(key, CURRENT_PARAMS_URL)\r\n        }\r\n        return acc\r\n      }, {})\r\n  \r\n      return params as MergeParams<M, O>\r\n    }\r\n  type keys = keyof MergeParams<M, O>\r\n  // Note: in this way the return of the getParam function is typed dynamically, thus having autocomplete in the IDE (eg: value.split(','))\r\n  type TagReturn<T extends boolean> = T extends true ? string[] : string;\r\n  const getParam = <T extends boolean>(key: keys, options?: { convert: T }): TagReturn<T>  => {\r\n\r\n    const keyStr = String(key)\r\n    // @ts-ignore\r\n    const value = options?.convert === true ? convertOriginalType(searchParams.get(keyStr), keyStr) : getStringUrl(keyStr,  CURRENT_PARAMS_URL)\r\n    return value as TagReturn<T> \r\n  }\r\n  \r\n  type OptionalParamsFiltered = Partial<O>\r\n\r\n  const calculateOmittedParameters = (newParams: Record<string, unknown | unknown[]>, keepParams: Record<string, boolean>) => {\r\n    // Calculate the ommited parameters, that is, the parameters that have not been sent in the request\r\n    const params = getParams()\r\n    // hasOw\r\n    // Note: it will be necessary to omit the parameters that are arrays because the idea is not to replace them but to add or remove some values\r\n    const newParamsWithoutArray = Object.entries(newParams).filter(([key,]) => !Array.isArray(TOTAL_PARAMS_PAGE[key]))\r\n    const result = Object.assign({\r\n      ...params,\r\n      ...Object.fromEntries(newParamsWithoutArray),\r\n      ...forceParams // the forced parameters will always be sent and will maintain their value\r\n    })\r\n    const paramsFiltered: OptionalParamsFiltered = Object.keys(result).reduce((acc, key) => {\r\n      // for default no parameters are omitted unless specified in the keepParams object\r\n      if (Object.prototype.hasOwnProperty.call(keepParams, key) && keepParams[key] === false) {\r\n        return acc\r\n      // Note: They array of parameters omitted by values (e.g., ['all', 'default']) are omitted since they are usually a default value that is not desired to be sent\r\n      } else if (!!result[key] !== false && !omitParamsByValues.includes(result[key])) {\r\n        // @ts-ignore\r\n        acc[key] = result[key]\r\n      }\r\n\r\n      return acc\r\n    }, {})\r\n\r\n    return {\r\n      ...mandatory,\r\n      ...paramsFiltered\r\n    } \r\n  }\r\n    // @ts-ignore\r\n  const sortParameters = (paramsFiltered) => {\r\n    // sort the parameters according to the structure so that it persists with each change in the URL, eg: localhost:3000/?page=1&page_size=10\r\n    // Note: this visibly improves the user experience\r\n    const orderedParams = PARAM_ORDER.reduce((acc, key) => {\r\n      if (Object.prototype.hasOwnProperty.call(paramsFiltered, key)) {\r\n          // @ts-ignore\r\n        acc[key] = paramsFiltered[key]\r\n      }\r\n\r\n      return acc\r\n    }, {})\r\n    return orderedParams\r\n  }\r\n\r\n  const mandatoryParameters = () => {\r\n    // Note: in case there are arrays in the URL, they are converted to their original form ej: tags=['tag1', 'tag2'] otherwise the parameters are extracted without converting to optimize performance\r\n    const isNecessaryConvert: boolean = ARRAY_KEYS.length > 0 ? true : false\r\n    const totalParametros: Record<string, unknown>  = getParams({ convert: isNecessaryConvert })\r\n\r\n    const paramsUrlFound: Record<string, boolean> = Object.keys(totalParametros).reduce(\r\n      (acc, key) => {\r\n        if (Object.prototype.hasOwnProperty.call(mandatory, key)) {\r\n          // @ts-ignore\r\n          acc[key] = totalParametros[key]\r\n        }\r\n        return acc\r\n      },\r\n      {}\r\n    )\r\n\r\n    return paramsUrlFound\r\n  }\r\n\r\n  const clearParams = ({ keepMandatoryParams = true } = {}): void => {\r\n    // for default, the mandatory parameters are not cleared since the current pagination would be lost\r\n    const paramsTransformed = transformParamsToURLSearch(\r\n      {\r\n        ...mandatory,\r\n     \r\n         ...(keepMandatoryParams && {\r\n          ...mandatoryParameters()\r\n        }),\r\n        ...forceParams \r\n      }\r\n    )\r\n    setSearchParams(paramsTransformed) \r\n  }\r\n\r\n  // transforms the keys to boolean to know which parameters to keep\r\n  type KeepParamsTransformedValuesBoolean = Partial<Record<keyof typeof TOTAL_PARAMS_PAGE, boolean>>\r\n  type NewParams = Partial<typeof TOTAL_PARAMS_PAGE> \r\n  type KeepParams = KeepParamsTransformedValuesBoolean\r\n  const updateParams = ({ newParams = {} as NewParams, keepParams = {} as KeepParams } = {}) => {\r\n\r\n    if (\r\n      Object.keys(newParams).length === 0 &&\r\n      Object.keys(keepParams).length === 0\r\n    ) {\r\n      clearParams()\r\n      return\r\n    }\r\n    // @ts-ignore\r\n    const finallyParamters = calculateOmittedParameters(newParams, keepParams)\r\n\r\n    const convertedArrayValues = appendArrayValues(finallyParamters, newParams)\r\n\r\n    const paramsSorted = sortParameters(convertedArrayValues)\r\n\r\n    setSearchParams(transformParamsToURLSearch(paramsSorted))\r\n\r\n  }\r\n\r\n    // only for the keys of the parameters to subscribe to changes in the URL to trigger the callback\r\n    const onChange = useCallback( (paramName: keys, callbacks: Array<() => void>) => {\r\n      const paramNameStr = String(paramName)\r\n      // replace the previous callbacks with the new ones so as not to accumulate callbacks\r\n      subscriptionsRef.current[paramNameStr] = callbacks;\r\n    }, [])\r\n  \r\n    // each time searchParams changes, we notify the subscribers\r\n    useEffect(() => {\r\n\r\n      for (const [key, value] of Object.entries(subscriptionsRef.current)) {\r\n\r\n        const newValue = CURRENT_PARAMS_URL[key] ?? null \r\n        const oldValue = previousParamsRef.current[key] ?? null\r\n        if (newValue !== oldValue) {\r\n          \r\n          for (const callback of value) {\r\n            console.log(value)\r\n\r\n            callback()\r\n\r\n          }\r\n        }\r\n        // once the callback is executed, the previous value is updated to ensure that the next time the value changes, the callback is executed\r\n        previousParamsRef.current[key] = newValue\r\n      }\r\n\r\n      \r\n    }, [CURRENT_PARAMS_URL])\r\n  return {\r\n    searchParams,\r\n    updateParams,\r\n    clearParams,\r\n    getParams,\r\n    getParam,\r\n    onChange\r\n  }\r\n}\r\n"],"names":["_ref","mandatory","_ref$mandatory","_ref$optional","optional","_ref$defaultParams","defaultParams","_ref$arraySerializati","arraySerialization","_ref$forceParams","forceParams","_ref$omitParamsByValu","omitParamsByValues","_useSearchParams","useSearchParams","searchParams","setSearchParams","subscriptionsRef","useRef","previousParamsRef","TOTAL_PARAMS_PAGE","useMemo","_extends","PARAM_ORDER","Array","from","Object","keys","ARRAY_KEYS","filter","key","isArray","transformParamsToURLSearch","params","console","log","PARAMS_RECIBIDOS_TRANSFORM","newParam","URLSearchParams","_i","_paramsKeys","length","arrayValue","csvValue","join","set","_step","_iterator","_createForOfIteratorHelperLoose","done","item","value","append","_step2","_iterator2","FINAL","toString","hasForcedParamsValues","_ref2","compareParams","entries","paramsForced","every","_ref3","useEffect","keysDefaultParams","keysForceParams","defaultParamsString","paramsUrl","getParams","paramsUrlString","forceParamsString","isIncludesForcedParams","updateParams","newParams","handleStartingParams","convertOriginalType","parseInt","getAll","split","SEARCH_PARAMS","getStringUrl","_transformParamsToURL3","_transformParamsToURL","arrayUrl","encodedQueryArray","decodeURIComponent","_transformParamsToURL2","CURRENT_PARAMS_URL","_step3","paramsObj","_iterator3","_step3$value","endsWith","bareKey","replace","push","getParamsObj","fromEntries","_temp","_ref4$convert","convert","reduce","acc","prototype","hasOwnProperty","call","clearParams","_temp2","totalParametros","_ref6$keepMandatoryPa","keepMandatoryParams","paramsTransformed","_temp3","_ref7$newParams","_ref7","_ref7$keepParams","keepParams","paramsFiltered","convertedArrayValues","finallyParams","updatedParams","forEach","currentValues","get","map","v","trim","Boolean","urlParams","REPEAT","BRACKETS","_searchParams$get","undefined","incoming","combined","includes","concat","CONBINED_STRING","Set","appendArrayValues","newParamsWithoutArray","_ref5","result","assign","calculateOmittedParameters","paramsSorted","onChange","useCallback","paramName","callbacks","paramNameStr","String","current","_i2","_Object$entries","_CURRENT_PARAMS_URL$k","_previousParamsRef$cu","_Object$entries$_i","newValue","_step4","_iterator4","callback","getParam","options","keyStr"],"mappings":"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"}
+{"version":3,"file":"react-magic-search-params.cjs.production.min.js","sources":["../src/useMagicSearchParams.ts"],"sourcesContent":["import { useSearchParams } from 'react-router-dom'\r\nimport { useMemo, useEffect, useRef, useCallback } from 'react'\r\n\r\n\r\n// Custom hook with advanced techniques to handle search parameters for any pagination\r\n\r\ntype CommonParams = {\r\n  page?: number\r\n  page_size?: number\r\n}\r\n/*\r\nMaps all properties of M (mandatory) as required\r\nand all properties of O (optional) as optional. \r\n*/\r\ntype MergeParams<M, O> = {\r\n  [K in keyof M]: M[K]\r\n} & {\r\n  [K in keyof O]?: O[K]\r\n}\r\n/**\r\n * Interface for the configuration object that the hook receives \r\n */\r\nexport interface UseMagicSearchParamsOptions<\r\n  M extends Record<string, unknown>,\r\n  O extends Record<string, unknown>\r\n> {\r\n  mandatory: M \r\n  optional?: O\r\n  defaultParams?: Partial<MergeParams<M, O>>\r\n  forceParams?: Partial<MergeParams<M, O>> // transform all to partial to avoid errors\r\n  arraySerialization?: 'csv' | 'repeat' | 'brackets' // technical to serialize arrays in the URL\r\n  omitParamsByValues?: Array<'all' | 'default' | 'unknown' | 'none' | 'void '> \r\n}\r\n\r\n/** \r\nGeneric hook to handle search parameters in the URL\r\n@param mandatory - Mandatory parameters (e.g., page=1, page_size=10, etc.)\r\n@param optional - Optional parameters (e.g., order, search, etc.)\r\n@param defaultParams - Default parameters sent in the URL on initialization\r\n@param forceParams - Parameters forced into the URL regardless of user input\r\n@param omitParamsByValues - Parameters omitted if they have specific values \r\n*/\r\nexport const useMagicSearchParams = <\r\n  M extends Record<string, unknown> & CommonParams,\r\n  O extends Record<string, unknown>,\r\n>({\r\n  mandatory = {} as M,\r\n  optional = {} as O,\r\n  defaultParams = {} as Partial<MergeParams<M, O>>,\r\n  arraySerialization = 'csv',\r\n  forceParams = {} as  {} as Partial<MergeParams<M, O>>,\r\n  omitParamsByValues = [] as Array<'all' | 'default' | 'unknown' | 'none' | 'void '>\r\n}: UseMagicSearchParamsOptions<M, O>)=> {\r\n\r\n  const [searchParams, setSearchParams] = useSearchParams() \r\n    // Ref to store subscriptions: { paramName: [callback1, callback2, ...] }\r\n  const subscriptionsRef = useRef<Record<string, Array<() => unknown>>>({}); \r\n  const previousParamsRef = useRef<Record<string, unknown>>({})\r\n\r\n  const TOTAL_PARAMS_PAGE: MergeParams<M, O> = useMemo(() => {\r\n    return { ...mandatory, ...optional };\r\n  }, [mandatory, optional]);\r\n\r\n  const PARAM_ORDER = useMemo(() => {\r\n    return Array.from(Object.keys(TOTAL_PARAMS_PAGE))\r\n  }, [TOTAL_PARAMS_PAGE])\r\n\r\n  // we get the keys that are arrays according to TOTAL_PARAMS_PAGE since these require special treatment in the URL due to serialization mode\r\n  const ARRAY_KEYS = useMemo(() => {\r\n    return Object.keys(TOTAL_PARAMS_PAGE).filter(\r\n      (key) => Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n    );\r\n  }, [TOTAL_PARAMS_PAGE])\r\n\r\n  const appendArrayValues = (\r\n    finallyParams: Record<string, unknown>,\r\n    newParams: Record<string, string | string[] | unknown>\r\n  ): Record<string, unknown> => {\r\n \r\n    // Note: We cannot modify the object of the final parameters directly, as immutability must be maintained\r\n    const updatedParams = { ...finallyParams };\r\n  \r\n\r\n    if (ARRAY_KEYS.length === 0) return updatedParams;\r\n  \r\n    ARRAY_KEYS.forEach((key) => {\r\n      // We use the current values directly from searchParams (source of truth)\r\n      // This avoids depending on finallyParams in which the arrays have been omitted\r\n      let currentValues = []; \r\n      switch (arraySerialization) {\r\n        case 'csv': {\r\n          const raw = searchParams.get(key) || '';\r\n          // For csv we expect \"value1,value2,...\" (no prefix)\r\n          currentValues = raw.split(',')\r\n            .map((v) => v.trim())\r\n            .filter(Boolean) as Array<string>\r\n          break;\r\n        }\r\n        case 'repeat': {\r\n          // Here we get all ocurrences of key\r\n          const urlParams = searchParams.getAll(key) as Array<string>\r\n          currentValues = urlParams.length > 0 ? urlParams : []\r\n          \r\n          console.log({REPEAT: currentValues})\r\n          break;\r\n        }\r\n        case 'brackets': {\r\n           // Build URLSearchParams from current parameters (to ensure no serialized values are taken previously)\r\n            const urlParams = searchParams.getAll(`${key}[]`) as Array<string>\r\n            currentValues = urlParams.length > 0 ? urlParams : []\r\n            console.log({BRACKETS: urlParams})\r\n        \r\n    \r\n            break;\r\n        }\r\n        default: {\r\n          // Mode by default works as csv\r\n          const raw = searchParams.get(key) ?? '';\r\n          currentValues = raw.split(',')\r\n            .map((v) => v.trim())\r\n            .filter(Boolean);\r\n          }\r\n        break; \r\n      }\r\n      // Update array values with new ones\r\n    \r\n      if (newParams[key] !== undefined) {\r\n        const incoming = newParams[key];\r\n        let combined: string[] = []\r\n        if (typeof incoming === 'string') {\r\n          // If it is a string, it is toggled (add/remove)\r\n          combined = currentValues.includes(incoming)\r\n            ? currentValues.filter((v) => v !== incoming)\r\n            : [...currentValues, incoming];\r\n          console.log({currentValues})\r\n            console.log({incoming})\r\n          console.log({CONBINED_STRING: combined})\r\n        } else if (Array.isArray(incoming)) {\r\n          // if an array is passed, repeated values are merged into a single value\r\n          // Note: Set is used to remove duplicates\r\n          combined = Array.from(new Set([ ...incoming]));\r\n          console.log({incoming})\r\n          console.log({combined})\r\n        } else {\r\n       \r\n          combined = currentValues;\r\n        }\r\n\r\n        updatedParams[key] = combined\r\n\r\n      }\r\n    });\r\n    return updatedParams\r\n  };\r\n\r\n  const transformParamsToURLSearch = (params: Record<string, unknown>): URLSearchParams => {\r\n    console.log({PARAMS_RECIBIDOS_TRANSFORM: params})\r\n\r\n    const newParam: URLSearchParams = new URLSearchParams()\r\n\r\n    const paramsKeys = Object.keys(params)\r\n\r\n    for (const key of paramsKeys) {\r\n      if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n        const arrayValue = params[key] as unknown[]\r\n        console.log({arrayValue})\r\n        switch (arraySerialization) {\r\n          case 'csv': {\r\n            const csvValue = arrayValue.join(',')\r\n            // set ensure that the previous value is replaced\r\n            newParam.set(key, csvValue)\r\n            break\r\n          } case 'repeat': {\r\n      \r\n            for (const item of arrayValue) {\r\n              console.log({item})\r\n              // add new value to the key, instead of replacing it\r\n              newParam.append(key, item as string)\r\n   \r\n            }\r\n            break\r\n          } case 'brackets': {\r\n            for (const item of arrayValue) {\r\n              newParam.append(`${key}[]`, item as string)\r\n            }\r\n            break\r\n          } default: {\r\n            const csvValue = arrayValue.join(',')\r\n            newParam.set(key, csvValue)\r\n          }\r\n        }\r\n      } else {\r\n        newParam.set(key, params[key] as string)\r\n      }\r\n    }\r\n    return newParam\r\n  }\r\n  // @ts-ignore\r\n  const hasForcedParamsValues = ({ paramsForced, compareParams }) => {\r\n\r\n    // Iterates over the forced parameters and verifies that they exist in the URL and match their values\r\n    // Ej: { page: 1, page_size: 10 } === { page: 1, page_size: 10 } => true\r\n    const allParamsMatch = Object.entries(paramsForced).every(\r\n      ([key, value]) => compareParams[key] === value\r\n    );\r\n\r\n    return allParamsMatch;\r\n  };\r\n  \r\n  useEffect(() => {\r\n\r\n    const keysDefaultParams: string[] = Object.keys(defaultParams)\r\n    const keysForceParams: string[] = Object.keys(forceParams)\r\n    if(keysDefaultParams.length === 0 && keysForceParams.length === 0) return\r\n  \r\n\r\n    function handleStartingParams() {\r\n\r\n      const defaultParamsString  = transformParamsToURLSearch(defaultParams).toString()\r\n      const paramsUrl = getParams()\r\n      const paramsUrlString = transformParamsToURLSearch(paramsUrl).toString()\r\n      const forceParamsString = transformParamsToURLSearch(forceParams).toString()\r\n\r\n      console.log({defaultParamsString})\r\n\r\n      const isForcedParams: boolean = hasForcedParamsValues({ paramsForced: forceParams, compareParams: paramsUrl })\r\n\r\n      if (!isForcedParams) {\r\n\r\n        // In this case, the forced parameters take precedence over the default parameters and the parameters of the current URL (which could have been modified by the user, e.g., page_size=1000)\r\n\r\n        updateParams({ newParams: {\r\n          ...defaultParams,\r\n          ...forceParams\r\n        }})\r\n        return\r\n      }\r\n      // In this way it will be validated that the forced parameters keys and values are in the current URL\r\n      const isIncludesForcedParams = hasForcedParamsValues({ paramsForced: forceParamsString, compareParams: defaultParams })\r\n\r\n      if (keysDefaultParams.length > 0 && isIncludesForcedParams) {\r\n        if (defaultParamsString === paramsUrlString) return // this means that the URL already has the default parameters\r\n        updateParams({ newParams: defaultParams })\r\n      }\r\n\r\n    }\r\n    handleStartingParams()\r\n\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  }, [])\r\n\r\n  /**\r\n   * Convert a string value to its original type (number, boolean, array) according to TOTAL_PARAMS_PAGE\r\n   * @param value - Chain obtained from the URL\r\n   * @param key - Key of the parameter\r\n   */\r\n  const convertOriginalType = (value: string, key: string) => {\r\n    // Given that the parameters of a URL are recieved as strings, they are converted to their original type\r\n    if (typeof TOTAL_PARAMS_PAGE[key] === 'number') {\r\n      return parseInt(value)\r\n    } else if (typeof TOTAL_PARAMS_PAGE[key] === 'boolean') {\r\n      return value === 'true'\r\n    } else if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n      // The result will be a valid array represented in the URL ej: tags=tag1,tag2,tag3 to ['tag1', 'tag2', 'tag3'], useful to combine the values of the arrays with the new ones\r\n \r\n      if (arraySerialization === 'csv') {\r\n        return searchParams.getAll(key).join('').split(',')\r\n      } else if (arraySerialization === 'repeat') {\r\n    \r\n        console.log({SEARCH_PARAMS: searchParams.getAll(key)})\r\n        return searchParams.getAll(key)\r\n      } else if (arraySerialization === 'brackets') {\r\n        return searchParams.getAll(`${key}[]`)\r\n      }\r\n     \r\n     \r\n    }\r\n    // Note: dates are not converted as it is better to handle them directly in the component that receives them, using a library like < date-fns >\r\n    return value\r\n  }\r\n  \r\n    /**\r\n   * Gets the current parameters from the URL and converts them to their original type if desired\r\n   * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n   */\r\n    const getStringUrl = (key: string, paramsUrl: Record<string, unknown>) => {\r\n      const isKeyArray = Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n      if (isKeyArray) {\r\n\r\n        if (arraySerialization === 'brackets') {\r\n\r\n          const arrayUrl = searchParams.getAll(`${key}[]`)\r\n          const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayUrl }).toString()\r\n          // in this way the array of the URL is decoded to its original form ej: tags[]=tag1&tags[]=tag2&tags[]=tag3\r\n          const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n          return unencodeQuery\r\n        } else if (arraySerialization === 'csv') {\r\n          const arrayValue = searchParams.getAll(key)\r\n          const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n          const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n          return unencodeQuery\r\n        }\r\n        const arrayValue = searchParams.getAll(key)\r\n        const stringResult = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n        return stringResult\r\n      } else {\r\n   \r\n        return paramsUrl[key] as string\r\n      }\r\n     }\r\n     const getParamsObj = (searchParams: URLSearchParams): Record<string, string | string[]> => {\r\n      const paramsObj: Record<string, string | string[]> = {};\r\n      // @ts-ignore\r\n      for (const [key, value] of searchParams.entries()) {\r\n        if (key.endsWith('[]')) {\r\n          const bareKey = key.replace('[]', '');\r\n          if (paramsObj[bareKey]) {\r\n            (paramsObj[bareKey] as string[]).push(value);\r\n          } else {\r\n            paramsObj[bareKey] = [value];\r\n          }\r\n        } else {\r\n          // If the key already exists, it is a repeated parameter\r\n          if (paramsObj[key]) {\r\n            if (Array.isArray(paramsObj[key])) {\r\n              (paramsObj[key] as string[]).push(value);\r\n            } else {\r\n              paramsObj[key] = [paramsObj[key] as string, value];\r\n            }\r\n          } else {\r\n            paramsObj[key] = value;\r\n          }\r\n        }\r\n      }\r\n      return paramsObj;\r\n     }\r\n    // Optimization: While the parameters are not updated, the current parameters of the URL are not recalculated\r\n    const CURRENT_PARAMS_URL: Record<string, unknown> = useMemo(() => {\r\n\r\n      return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries())\r\n    }, [searchParams, arraySerialization])\r\n\r\n    /**\r\n      * Gets the current parameters from the URL and converts them to their original type if desired\r\n     * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n     * @returns - Returns the current parameters of the URL\r\n     */\r\n    const getParams = ({ convert = true } = {}): MergeParams<M, O> => {\r\n      // All the paramteres are extracted from the URL and converted into an object\r\n\r\n      const params = Object.keys(CURRENT_PARAMS_URL).reduce((acc, key) => {\r\n        if (Object.prototype.hasOwnProperty.call(TOTAL_PARAMS_PAGE, key)) {\r\n          const realKey = arraySerialization === 'brackets' ? key.replace('[]', '') : key\r\n          // @ts-ignore\r\n          acc[realKey] = convert === true\r\n            ? convertOriginalType(CURRENT_PARAMS_URL[key] as string, key)\r\n            :  getStringUrl(key, CURRENT_PARAMS_URL)\r\n        }\r\n        return acc\r\n      }, {})\r\n  \r\n      return params as MergeParams<M, O>\r\n    }\r\n  type keys = keyof MergeParams<M, O>\r\n  // Note: in this way the return of the getParam function is typed dynamically, thus having autocomplete in the IDE (eg: value.split(','))\r\n  type TagReturn<T extends boolean> = T extends true ? string[] : string;\r\n  /**\r\n    * Gets the value of a parameter from the URL and converts it to its original type if desired\r\n   * @param key - Key of the parameter\r\n   * @param options - Options to convert the value to its original type, default is true\r\n   * @returns - Returns the value of the parameter\r\n   */\r\n\r\n  const getParam = <T extends boolean>(key: keys, options?: { convert: T }): TagReturn<T>  => {\r\n\r\n    const keyStr = String(key)\r\n    // @ts-ignore\r\n    const value = options?.convert === true ? convertOriginalType(searchParams.get(keyStr), keyStr) : getStringUrl(keyStr,  CURRENT_PARAMS_URL)\r\n    return value as TagReturn<T> \r\n  }\r\n  \r\n  type OptionalParamsFiltered = Partial<O>\r\n\r\n  const calculateOmittedParameters = (newParams: Record<string, unknown | unknown[]>, keepParams: Record<string, boolean>) => {\r\n    // Calculate the ommited parameters, that is, the parameters that have not been sent in the request\r\n    const params = getParams()\r\n    // hasOw\r\n    // Note: it will be necessary to omit the parameters that are arrays because the idea is not to replace them but to add or remove some values\r\n    const newParamsWithoutArray = Object.entries(newParams).filter(([key,]) => !Array.isArray(TOTAL_PARAMS_PAGE[key]))\r\n    const result = Object.assign({\r\n      ...params,\r\n      ...Object.fromEntries(newParamsWithoutArray),\r\n      ...forceParams // the forced parameters will always be sent and will maintain their value\r\n    })\r\n    const paramsFiltered: OptionalParamsFiltered = Object.keys(result).reduce((acc, key) => {\r\n      // for default no parameters are omitted unless specified in the keepParams object\r\n      if (Object.prototype.hasOwnProperty.call(keepParams, key) && keepParams[key] === false) {\r\n        return acc\r\n      // Note: They array of parameters omitted by values (e.g., ['all', 'default']) are omitted since they are usually a default value that is not desired to be sent\r\n      } else if (!!result[key] !== false && !omitParamsByValues.includes(result[key])) {\r\n        // @ts-ignore\r\n        acc[key] = result[key]\r\n      }\r\n\r\n      return acc\r\n    }, {})\r\n\r\n    return {\r\n      ...mandatory,\r\n      ...paramsFiltered\r\n    } \r\n  }\r\n    // @ts-ignore\r\n  const sortParameters = (paramsFiltered) => {\r\n    // sort the parameters according to the structure so that it persists with each change in the URL, eg: localhost:3000/?page=1&page_size=10\r\n    // Note: this visibly improves the user experience\r\n    const orderedParams = PARAM_ORDER.reduce((acc, key) => {\r\n      if (Object.prototype.hasOwnProperty.call(paramsFiltered, key)) {\r\n          // @ts-ignore\r\n        acc[key] = paramsFiltered[key]\r\n      }\r\n\r\n      return acc\r\n    }, {})\r\n    return orderedParams\r\n  }\r\n\r\n  const mandatoryParameters = () => {\r\n    // Note: in case there are arrays in the URL, they are converted to their original form ej: tags=['tag1', 'tag2'] otherwise the parameters are extracted without converting to optimize performance\r\n    const isNecessaryConvert: boolean = ARRAY_KEYS.length > 0 ? true : false\r\n    const totalParametros: Record<string, unknown>  = getParams({ convert: isNecessaryConvert })\r\n\r\n    const paramsUrlFound: Record<string, boolean> = Object.keys(totalParametros).reduce(\r\n      (acc, key) => {\r\n        if (Object.prototype.hasOwnProperty.call(mandatory, key)) {\r\n          // @ts-ignore\r\n          acc[key] = totalParametros[key]\r\n        }\r\n        return acc\r\n      },\r\n      {}\r\n    )\r\n\r\n    return paramsUrlFound\r\n  }\r\n  /**\r\n   clears the parameters of the URL, keeping the mandatory parameters\r\n   * @param keepMandatoryParams - If true, the mandatory parameters are kept in the URL\r\n   */\r\n\r\n  const clearParams = ({ keepMandatoryParams = true } = {}): void => {\r\n    // for default, the mandatory parameters are not cleared since the current pagination would be lost\r\n    const paramsTransformed = transformParamsToURLSearch(\r\n      {\r\n        ...mandatory,\r\n     \r\n         ...(keepMandatoryParams && {\r\n          ...mandatoryParameters()\r\n        }),\r\n        ...forceParams \r\n      }\r\n    )\r\n    setSearchParams(paramsTransformed) \r\n  }\r\n\r\n  // transforms the keys to boolean to know which parameters to keep\r\n  type KeepParamsTransformedValuesBoolean = Partial<Record<keyof typeof TOTAL_PARAMS_PAGE, boolean>>\r\n  type NewParams = Partial<typeof TOTAL_PARAMS_PAGE> \r\n  type KeepParams = KeepParamsTransformedValuesBoolean\r\n  /**\r\n   Merges the new parameters with the current ones, omits the parameters that are not sent and sorts them according to the structure\r\n   * @param newParams - New parameters to be sent in the URL\r\n   * @param keepParams - Parameters to keep in the URL, default is true\r\n   */\r\n  const updateParams = ({ newParams = {} as NewParams, keepParams = {} as KeepParams } = {}) => {\r\n\r\n    if (\r\n      Object.keys(newParams).length === 0 &&\r\n      Object.keys(keepParams).length === 0\r\n    ) {\r\n      clearParams()\r\n      return\r\n    }\r\n    // @ts-ignore\r\n    const finallyParamters = calculateOmittedParameters(newParams, keepParams)\r\n\r\n    const convertedArrayValues = appendArrayValues(finallyParamters, newParams)\r\n\r\n    const paramsSorted = sortParameters(convertedArrayValues)\r\n\r\n    setSearchParams(transformParamsToURLSearch(paramsSorted))\r\n\r\n  }\r\n\r\n  /**\r\n   * @param paramName - Name of the parameter to subscribe to\r\n   * @param callbacks - Callbacks to be executed when the parameter changes\r\n   * @returns - Returns the function to unsubscribe\r\n   */\r\n    const onChange = useCallback( (paramName: keys, callbacks: Array<() => void>) => {\r\n      const paramNameStr = String(paramName)\r\n      // replace the previous callbacks with the new ones so as not to accumulate callbacks\r\n      subscriptionsRef.current[paramNameStr] = callbacks;\r\n    }, [])\r\n  \r\n    // each time searchParams changes, we notify the subscribers\r\n    useEffect(() => {\r\n\r\n      for (const [key, value] of Object.entries(subscriptionsRef.current)) {\r\n\r\n        const newValue = CURRENT_PARAMS_URL[key] ?? null \r\n        const oldValue = previousParamsRef.current[key] ?? null\r\n        if (newValue !== oldValue) {\r\n          \r\n          for (const callback of value) {\r\n            callback()\r\n\r\n          }\r\n        }\r\n        // once the callback is executed, the previous value is updated to ensure that the next time the value changes, the callback is executed\r\n        previousParamsRef.current[key] = newValue\r\n      }\r\n\r\n      \r\n    }, [CURRENT_PARAMS_URL])\r\n  return {\r\n    searchParams,\r\n    updateParams,\r\n    clearParams,\r\n    getParams,\r\n    getParam,\r\n    onChange\r\n  }\r\n}\r\n\r\n"],"names":["_ref","mandatory","_ref$mandatory","_ref$optional","optional","_ref$defaultParams","defaultParams","_ref$arraySerializati","arraySerialization","_ref$forceParams","forceParams","_ref$omitParamsByValu","omitParamsByValues","_useSearchParams","useSearchParams","searchParams","setSearchParams","subscriptionsRef","useRef","previousParamsRef","TOTAL_PARAMS_PAGE","useMemo","_extends","PARAM_ORDER","Array","from","Object","keys","ARRAY_KEYS","filter","key","isArray","transformParamsToURLSearch","params","console","log","PARAMS_RECIBIDOS_TRANSFORM","newParam","URLSearchParams","_i","_paramsKeys","length","arrayValue","csvValue","join","set","_step","_iterator","_createForOfIteratorHelperLoose","done","item","value","append","_step2","_iterator2","hasForcedParamsValues","_ref2","compareParams","entries","paramsForced","every","_ref3","useEffect","keysDefaultParams","keysForceParams","defaultParamsString","toString","paramsUrl","getParams","paramsUrlString","forceParamsString","isIncludesForcedParams","updateParams","newParams","handleStartingParams","convertOriginalType","parseInt","getAll","split","SEARCH_PARAMS","getStringUrl","_transformParamsToURL3","_transformParamsToURL","arrayUrl","encodedQueryArray","decodeURIComponent","_transformParamsToURL2","CURRENT_PARAMS_URL","_step3","paramsObj","_iterator3","_step3$value","endsWith","bareKey","replace","push","getParamsObj","fromEntries","_temp","_ref4$convert","convert","reduce","acc","prototype","hasOwnProperty","call","clearParams","_temp2","totalParametros","_ref6$keepMandatoryPa","keepMandatoryParams","paramsTransformed","_temp3","_ref7$newParams","_ref7","_ref7$keepParams","keepParams","paramsFiltered","convertedArrayValues","finallyParams","updatedParams","forEach","currentValues","get","map","v","trim","Boolean","urlParams","REPEAT","BRACKETS","_searchParams$get","undefined","incoming","combined","includes","concat","CONBINED_STRING","Set","appendArrayValues","newParamsWithoutArray","_ref5","result","assign","calculateOmittedParameters","paramsSorted","onChange","useCallback","paramName","callbacks","paramNameStr","String","current","_i2","_Object$entries","_CURRENT_PARAMS_URL$k","_previousParamsRef$cu","_Object$entries$_i","newValue","_step4","_iterator4","callback","getParam","options","keyStr"],"mappings":"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"}

package/dist/react-magic-search-params.esm.js

@@ -162,9 +162,6 @@ var useMagicSearchParams = function useMagicSearchParams(_ref) {
         updatedParams[key] = combined;
       }
     });
-    console.log({
-      updatedParams: updatedParams
-    });
     return updatedParams;
   };
   var transformParamsToURLSearch = function transformParamsToURLSearch(params) {
@@ -218,9 +215,6 @@ var useMagicSearchParams = function useMagicSearchParams(_ref) {
         newParam.set(key, params[key]);
       }
     }
-    console.log({
-      FINAL: newParam.toString()
-    });
     return newParam;
   };
   // @ts-ignore
@@ -363,6 +357,11 @@ var useMagicSearchParams = function useMagicSearchParams(_ref) {
   var CURRENT_PARAMS_URL = useMemo(function () {
     return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries());
   }, [searchParams, arraySerialization]);
+  /**
+    * Gets the current parameters from the URL and converts them to their original type if desired
+   * @param convert - If true, converts from string to the inferred type (number, boolean, ...)
+   * @returns - Returns the current parameters of the URL
+   */
   var getParams = function getParams(_temp) {
     var _ref4 = _temp === void 0 ? {} : _temp,
       _ref4$convert = _ref4.convert,
@@ -378,6 +377,12 @@ var useMagicSearchParams = function useMagicSearchParams(_ref) {
     }, {});
     return params;
   };
+  /**
+    * Gets the value of a parameter from the URL and converts it to its original type if desired
+   * @param key - Key of the parameter
+   * @param options - Options to convert the value to its original type, default is true
+   * @returns - Returns the value of the parameter
+   */
   var getParam = function getParam(key, options) {
     var keyStr = String(key);
     // @ts-ignore
@@ -435,6 +440,10 @@ var useMagicSearchParams = function useMagicSearchParams(_ref) {
     }, {});
     return paramsUrlFound;
   };
+  /**
+   clears the parameters of the URL, keeping the mandatory parameters
+   * @param keepMandatoryParams - If true, the mandatory parameters are kept in the URL
+   */
   var clearParams = function clearParams(_temp2) {
     var _ref6 = _temp2 === void 0 ? {} : _temp2,
       _ref6$keepMandatoryPa = _ref6.keepMandatoryParams,
@@ -443,6 +452,11 @@ var useMagicSearchParams = function useMagicSearchParams(_ref) {
     var paramsTransformed = transformParamsToURLSearch(_extends({}, mandatory, keepMandatoryParams && _extends({}, mandatoryParameters()), forceParams));
     setSearchParams(paramsTransformed);
   };
+  /**
+   Merges the new parameters with the current ones, omits the parameters that are not sent and sorts them according to the structure
+   * @param newParams - New parameters to be sent in the URL
+   * @param keepParams - Parameters to keep in the URL, default is true
+   */
   var updateParams = function updateParams(_temp3) {
     var _ref7 = _temp3 === void 0 ? {} : _temp3,
       _ref7$newParams = _ref7.newParams,
@@ -459,7 +473,11 @@ var useMagicSearchParams = function useMagicSearchParams(_ref) {
     var paramsSorted = sortParameters(convertedArrayValues);
     setSearchParams(transformParamsToURLSearch(paramsSorted));
   };
-  // only for the keys of the parameters to subscribe to changes in the URL to trigger the callback
+  /**
+   * @param paramName - Name of the parameter to subscribe to
+   * @param callbacks - Callbacks to be executed when the parameter changes
+   * @returns - Returns the function to unsubscribe
+   */
   var onChange = useCallback(function (paramName, callbacks) {
     var paramNameStr = String(paramName);
     // replace the previous callbacks with the new ones so as not to accumulate callbacks
@@ -477,7 +495,6 @@ var useMagicSearchParams = function useMagicSearchParams(_ref) {
       if (newValue !== oldValue) {
         for (var _iterator4 = _createForOfIteratorHelperLoose(value), _step4; !(_step4 = _iterator4()).done;) {
           var callback = _step4.value;
-          console.log(value);
           callback();
         }
       }