@pagopa/selfcare-common-frontend 1.5.0 → 1.5.4

package/CHANGELOG.md

@@ -4,8 +4,33 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [v1.5.4](https://github.com/pagopa/selfcare-common-frontend/compare/v1.5.3...v1.5.4)
+
+- fixed useReduxCachedValueTranscoded parameters types [`#29`](https://github.com/pagopa/selfcare-common-frontend/pull/29)
+
+#### [v1.5.3](https://github.com/pagopa/selfcare-common-frontend/compare/v1.5.2...v1.5.3)
+
+> 15 February 2022
+
+- added useReduxCachedValueTranscoded [`#28`](https://github.com/pagopa/selfcare-common-frontend/pull/28)
+
+#### [v1.5.2](https://github.com/pagopa/selfcare-common-frontend/compare/v1.5.1...v1.5.2)
+
+> 14 February 2022
+
+- Fixed useReduxCachedValue setterAction type [`#27`](https://github.com/pagopa/selfcare-common-frontend/pull/27)
+- Bump follow-redirects from 1.14.7 to 1.14.8 [`#26`](https://github.com/pagopa/selfcare-common-frontend/pull/26)
+
+#### [v1.5.1](https://github.com/pagopa/selfcare-common-frontend/compare/v1.5.0...v1.5.1)
+
+> 14 February 2022
+
+- withRetrievedValue will accept a component to show while loading [`#25`](https://github.com/pagopa/selfcare-common-frontend/pull/25)
+
 #### [v1.5.0](https://github.com/pagopa/selfcare-common-frontend/compare/v1.4.1...v1.5.0)
 
+> 11 February 2022
+
 - Toast autoclosable in UserNotifyHandle and ErrorBoundaryfeatures [`#24`](https://github.com/pagopa/selfcare-common-frontend/pull/24)
 - Customhook cached redux [`#23`](https://github.com/pagopa/selfcare-common-frontend/pull/23)
 - fixed readme [`#22`](https://github.com/pagopa/selfcare-common-frontend/pull/22)

package/README.md

@@ -57,16 +57,16 @@ Modal used to show a list of values from which to choose a single value
 | Prop | Type | Mandatory | Description |
 |------|------|-----------|-------------|
 | open | boolean | Y | If the popup is to be displayed |
-| handleClose | React.MouseEventHandler<HTMLButtonElement> | Y | The function to be invoked when clicking on exit button or selecting a value |
+| handleClose | React.MouseEventHandler`<HTMLButtonElement>` | Y | The function to be invoked when clicking on exit button or selecting a value |
 | title | string | Y | The popup title |
-| filterModalConfig | FilterModalConfig<any, any> | N | See below  |
+| filterModalConfig | FilterModalConfig`<any, any>` | N | See below  |
 | height | string | N | The popup height |
 | minHeight | string | N | The popup minHeight |
 
 FilterModalConfig fields:
 | Field | Type | Mandatory | Description |
 |-------|------|-----------|-------------|
-| data | Array<T> | Y | The list of values between to which choose |
+| data | Array`<T>` | Y | The list of values between to which choose |
 | getLabel | (e: T) => string | Y | A function that will select the label to show |
 | getValue | (e: T) => string | Y | A function that will select the value to return when selecting an item |
 | onFilterChange | (v: V) => void | Y | The function invoked when selecting a value |
@@ -79,10 +79,10 @@ Selfcare's popup
 | open | boolean | Y | If this component should be displayed or not |
 | title | string | Y | The title to show in the popup |
 | message | React.ReactNode | Y | The body to show in the popup |
-| onConfirm | React.MouseEventHandler<HTMLButtonElement> | N | If defined, it will render a confirm button using this function as behavior |
+| onConfirm | React.MouseEventHandler`<HTMLButtonElement>` | N | If defined, it will render a confirm button using this function as behavior |
 | onConfirmLabel | string | N | The confirm label text |
-| handleClose | React.MouseEventHandler<HTMLButtonElement> | Y | The function invoked when clicking on close button or in the showed X icon |
-| handleExit | React.MouseEventHandler<HTMLButtonElement> | N | If defined, it allow to set a different behavior when clicking on X icon |
+| handleClose | React.MouseEventHandler`<HTMLButtonElement>` | Y | The function invoked when clicking on close button or in the showed X icon |
+| handleExit | React.MouseEventHandler`<HTMLButtonElement>` | N | If defined, it allow to set a different behavior when clicking on X icon |
 | onCloseLabel | string | N | Close button text |
 | height | string | N | The popup height |
 | minHeight | string | N | The popup minHeight |
@@ -132,7 +132,7 @@ To show an error popup to inform of the not valid session
 ### buildFetchApi = (timeoutMs: number = 300000) => fetch
 Return the implementation of fetch configured with a timeout
 
-### extractResponse <R>(response: t.Validation<TypeofApiResponse<any>>, successHttpStatus: number, onRedirectToLogin: () => void, notValidTokenHttpStatus: number | null = 401, notAuthorizedTokenHttpStatus: number | null = 403, emptyResponseHttpStatus: number | null = 404): Promise<R>
+### extractResponse `<R>`(response: t.Validation`<TypeofApiResponse<any>>`, successHttpStatus: number, onRedirectToLogin: () => void, notValidTokenHttpStatus: number | null = 401, notAuthorizedTokenHttpStatus: number | null = 403, emptyResponseHttpStatus: number | null = 404): Promise`<R>`
 Extract the response of a @pagopa/openapi-codegen-ts generated client rest invocation having status code successHttpStatus.
 If notValidTokenHttpStatus is not null and the returned status is equal to notValidTokenHttpStatus, it will call the onRedirectToLogin function and will schedule the redirect towards logout path.
 If notAuthorizedTokenHttpStatus is  not null and the returned status is equal to notAuthorizedTokenHttpStatus, it will throw an Error with message "Operation not allowed".
@@ -179,8 +179,23 @@ It's possible to modify the login path changing the value in [CONFIG.URL_FE.LOGI
 
 ## withRetrievedValue
 Decorator to retrieve a value and serve it once ready to the decorated component.
-It's recommended to use it together with [useReduxCachedValue](#usereduxcachedvalue)
-See withRetrievedValue.test.tsx file for an axample.
+Using it together with [useReduxCachedValue](#usereduxcachedvalue) will allow to build a component which will use centralized and cached data
+See withRetrievedValue.test.tsx file for an example.
+
+Given the following type parameters:
+* ENTITY_TYPE extends Record`<string, any>`,
+* PROP_NAME extends string,
+* PROPS extends Record`<PROP_NAME, ENTITY_TYPE>`
+
+The arguments to provide to the decorator are the following:
+
+| Prop | Type | Mandatory | Description |
+|------|------|-----------|-------------|
+| propEntityName | PROP_NAME | Y | The name of the prop to which serve the value when available |
+| getRetrieverService | () => () => Promise`<ENTITY_TYPE>` | Y | A function that will return an other function to retrieve the expected value. This for allow the use of custom hook  |
+| WrappedComponent | React.ComponentType`<PROPS>` | Y | The component to decore |
+| onError | (appError: AppError) => void | N | What to do in case of error. As default, it will use the feature ErrorBoundary |
+| onLoading | ReactNode | N | A component to show while waiting for the value |
 
 # Custom Hooks
 ## useFakePagination
@@ -189,8 +204,27 @@ Cached values are stored using useRef, so they are local to the component using
 The sorting actually is applied using string representation
 
 ## useReduxCachedValue
-It will return a method that only at the very first invocation it will call the retrieverService only the first time, storing the obtained values, and returning always cached values.
-See useReduxCachedValue.test.tsx file for an example
+See [useReduxCachedValueTranscoded](#usereduxcachedvaluetranscoded) when RETRIEVED_VALUE === RETRIEVER_ARGS
+
+## useReduxCachedValueTranscoded
+It will return a method that will call the retrieverService only when there are not storing values, or a condition on them is not more verified.
+See useReduxCachedValue.test.tsx file for an example.
+
+Given the following type parametes:
+* RETRIEVED_VALUE the type desired
+* STORED_VALUE the type stored
+
+The arguments to provide to the custom hook are the following:
+
+| Prop | Type | Mandatory | Description |
+|------|------|-----------|-------------|
+| entity | string | Y | The name of the entity, used just for logging purpose |
+| retrieverService | (retrieverServiceArgs: RETRIEVER_ARGS) => Promise`<RETRIEVED_VALUE>` | Y | The service that will retrieve the value |
+| reduxSelector | (state: any) => STORED_VALUE | undefined | Y | The selector to read the value from redux |
+| reduxSetterAction | (value: RETRIEVED_VALUE, retrieverServiceArgs: RETRIEVER_ARGS) => PayloadAction`<STORED_VALUE>` | Y | The action to store the value |
+| selectedValue2RetrievedValue | (value: STORED_VALUE) => RETRIEVED_VALUE | Y | A function called to transform STORED_VALUE into RETRIEVED_VALUE and called when hitting the cache |
+| selectedValuePredicate2Retrieve | (value: STORED_VALUE, retrieverServiceArgs: RETRIEVER_ARGS) => boolean | N | An optional predicate evaluated when reduxSelector returned some value in order to compare it against the retrieverServiceArgs and evaluate if retrieverService should be called again |
+| alwaysRetrieve | boolean | N | If true, it will always retrieve and store the new value |
 
 # Features
 ## LoadingOverlay
@@ -285,7 +319,7 @@ This feature can be configured with the following keys of the [CONFIG](#Configur
 | PERSISTENCE | string | Where to store session data, possible values are cookie or localStorage | localStorage |
 | LOG_IP | boolean | If the ip should be sent | false |
 | LOG_IP | boolean | If the ip should be sent | false |
-| PROPERTY_BLACKLIST | Array<string> | If the ip should be sent | ["$current_url", "$initial_referrer", "$referrer"] |
+| PROPERTY_BLACKLIST | Array`<string>` | If the ip should be sent | ["$current_url", "$initial_referrer", "$referrer"] |
 | ADDITIONAL_PROPERTIES | {[key: string]: string} | An object containing a fixed set of properties to send every time, overridden if the actual event will report the same properties | {} |
 | ADDITIONAL_PROPERTIES_IMPORTANT | {[key: string]: string} | As ADDITIONAL_PROPERTIES, but these properties will take the precedence overriding events conflicting properties | {} |
 

package/build.info

@@ -1,2 +1,2 @@
-20220211.1 - selfcare-common-frontend.deploy(20159)
-tags/v1.5.0^0 9cb310deb17715c689c21d21c46d8fe79593c30c
+20220215.2 - selfcare-common-frontend.deploy(20504)
+tags/v1.5.4^0 032705d5c019bf056fddfc1d2caf72cf8ed4db64

package/decorators/withRetrievedValue.d.ts

@@ -1,4 +1,14 @@
-/// <reference types="react" />
-import { AppError } from '../redux/slices/appStateSlice';
+import { ReactNode } from 'react';
+import { AppError } from '../model/AppError';
 /** Decorator to retrieve a value and serve it once ready to the decorated component */
-export default function withRetrievedValue<ENTITY_TYPE extends Record<string, any>, PROP_NAME extends string, PROPS extends Record<PROP_NAME, ENTITY_TYPE>>(propEntityName: PROP_NAME, getRetrieverService: () => () => Promise<ENTITY_TYPE>, WrappedComponent: React.ComponentType<PROPS>, onError?: (appError: AppError) => void): import("react").ComponentType<Omit<PROPS, PROP_NAME>>;
+export default function withRetrievedValue<ENTITY_TYPE extends Record<string, any>, PROP_NAME extends string, PROPS extends Record<PROP_NAME, ENTITY_TYPE>>(
+/** The name of the prop to which serve the value when available */
+propEntityName: PROP_NAME, 
+/** A function that will return an other function to retrieve the expected value. This for allow the use of custom hook  */
+getRetrieverService: () => () => Promise<ENTITY_TYPE>, 
+/** The component to decore */
+WrappedComponent: React.ComponentType<PROPS>, 
+/** What to do in case of error. As default, it will use the feature ErrorBoundary */
+onError?: (appError: AppError) => void, 
+/** A component to show while waiting for the value */
+onLoading?: ReactNode): import("react").ComponentType<Omit<PROPS, PROP_NAME>>;

package/decorators/withRetrievedValue.js

@@ -5,7 +5,17 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const useErrorDispatcher_1 = (0, tslib_1.__importDefault)(require("../hooks/useErrorDispatcher"));
 /** Decorator to retrieve a value and serve it once ready to the decorated component */
-function withRetrievedValue(propEntityName, getRetrieverService, WrappedComponent, onError) {
+function withRetrievedValue(
+/** The name of the prop to which serve the value when available */
+propEntityName, 
+/** A function that will return an other function to retrieve the expected value. This for allow the use of custom hook  */
+getRetrieverService, 
+/** The component to decore */
+WrappedComponent, 
+/** What to do in case of error. As default, it will use the feature ErrorBoundary */
+onError, 
+/** A component to show while waiting for the value */
+onLoading) {
     const displayName = WrappedComponent.displayName || WrappedComponent.name || 'Component';
     const ComponentWithParties = (props) => {
         const [value, setValue] = (0, react_1.useState)();
@@ -28,7 +38,7 @@ function withRetrievedValue(propEntityName, getRetrieverService, WrappedComponen
                 doRetrieve();
             }
         }, []);
-        return (value !== undefined && ((0, jsx_runtime_1.jsx)(WrappedComponent, Object.assign({}, props, { [propEntityName]: value }), void 0)));
+        return value !== undefined ? ((0, jsx_runtime_1.jsx)(WrappedComponent, Object.assign({}, props, { [propEntityName]: value }), void 0)) : (onLoading !== null && onLoading !== void 0 ? onLoading : (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, {}, void 0));
     };
     // eslint-disable-next-line functional/immutable-data
     ComponentWithParties.displayName = `withRetrieve${propEntityName}(${displayName})`;

package/decorators/withRetrievedValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"withRetrievedValue.js","sourceRoot":"","sources":["../../src/lib/decorators/withRetrievedValue.tsx"],"names":[],"mappings":";;;;AAAA,iCAA4C;AAC5C,kGAA6D;AAG7D,uFAAuF;AACvF,SAAwB,kBAAkB,CAKxC,cAAyB,EACzB,mBAAqD,EACrD,gBAA4C,EAC5C,OAAsC;IAEtC,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,IAAI,gBAAgB,CAAC,IAAI,IAAI,WAAW,CAAC;IAEzF,MAAM,oBAAoB,GAAG,CAAC,KAAY,EAAE,EAAE;QAC5C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,GAAe,CAAC;QAClD,MAAM,cAAc,GAAG,mBAAmB,EAAE,CAAC;QAE7C,MAAM,QAAQ,GAAG,IAAA,4BAAkB,GAAE,CAAC;QAEtC,MAAM,UAAU,GAAG,GAAS,EAAE;YAC5B,cAAc,EAAE;iBACb,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;iBACxB,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAChB,CAAC,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,QAAQ,CAAC,CAAC;gBACpB,EAAE,EAAE,kBAAkB,cAAc,EAAE;gBACtC,QAAQ,EAAE,KAAK;gBACf,eAAe,EAAE,yCAAyC,cAAc,EAAE;gBAC1E,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,UAAU;aACpB,CAAC,CACH,CAAC;QACN,CAAC,CAAC;QAEF,IAAA,iBAAS,EAAC,GAAG,EAAE;YACb,IAAI,CAAC,KAAK,EAAE;gBACV,UAAU,EAAE,CAAC;aACd;QACH,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,OAAO,CACL,KAAK,KAAK,SAAS,IAAI,CACrB,uBAAC,gBAAgB,oBAAM,KAAe,EAAM,EAAE,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,UAAI,CAC5E,CACF,CAAC;IACJ,CAAC,CAAC;IAEF,qDAAqD;IACrD,oBAAoB,CAAC,WAAW,GAAG,eAAe,cAAc,IAAI,WAAW,GAAG,CAAC;IAEnF,OAAO,oBAAmE,CAAC;AAC7E,CAAC;AAlDD,qCAkDC"}
+{"version":3,"file":"withRetrievedValue.js","sourceRoot":"","sources":["../../src/lib/decorators/withRetrievedValue.tsx"],"names":[],"mappings":";;;;AAAA,iCAAuD;AACvD,kGAA6D;AAG7D,uFAAuF;AACvF,SAAwB,kBAAkB;AAKxC,mEAAmE;AACnE,cAAyB;AACzB,2HAA2H;AAC3H,mBAAqD;AACrD,8BAA8B;AAC9B,gBAA4C;AAC5C,qFAAqF;AACrF,OAAsC;AACtC,sDAAsD;AACtD,SAAqB;IAErB,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,IAAI,gBAAgB,CAAC,IAAI,IAAI,WAAW,CAAC;IAEzF,MAAM,oBAAoB,GAAG,CAAC,KAAY,EAAE,EAAE;QAC5C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,GAAe,CAAC;QAClD,MAAM,cAAc,GAAG,mBAAmB,EAAE,CAAC;QAE7C,MAAM,QAAQ,GAAG,IAAA,4BAAkB,GAAE,CAAC;QAEtC,MAAM,UAAU,GAAG,GAAS,EAAE;YAC5B,cAAc,EAAE;iBACb,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;iBACxB,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAChB,CAAC,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,QAAQ,CAAC,CAAC;gBACpB,EAAE,EAAE,kBAAkB,cAAc,EAAE;gBACtC,QAAQ,EAAE,KAAK;gBACf,eAAe,EAAE,yCAAyC,cAAc,EAAE;gBAC1E,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,UAAU;aACpB,CAAC,CACH,CAAC;QACN,CAAC,CAAC;QAEF,IAAA,iBAAS,EAAC,GAAG,EAAE;YACb,IAAI,CAAC,KAAK,EAAE;gBACV,UAAU,EAAE,CAAC;aACd;QACH,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAC3B,uBAAC,gBAAgB,oBAAM,KAAe,EAAM,EAAE,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,UAAI,CAC5E,CAAC,CAAC,CAAC,CACF,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,0DAAK,CACnB,CAAC;IACJ,CAAC,CAAC;IAEF,qDAAqD;IACrD,oBAAoB,CAAC,WAAW,GAAG,eAAe,cAAc,IAAI,WAAW,GAAG,CAAC;IAEnF,OAAO,oBAAmE,CAAC;AAC7E,CAAC;AAxDD,qCAwDC"}

package/hooks/useReduxCachedValue.d.ts

@@ -1,4 +1,9 @@
-import { PayloadActionCreator } from '@reduxjs/toolkit';
-/** It will return a method that only at the very first invocation it will call the retrieverService only the first time, storing the obtained values, and returning always cached values */
-declare const useReduxCachedValue: <T extends any[] | Record<string, any>>(entity: string, retrieverService: () => Promise<T>, reduxSelector: (state: any) => T, reduxSetterAction: import("@reduxjs/toolkit/dist/tsHelpers").IsAny<T, import("@reduxjs/toolkit").ActionCreatorWithPayload<any, string>, import("@reduxjs/toolkit/dist/tsHelpers").IsUnknown<T, import("@reduxjs/toolkit").ActionCreatorWithNonInferrablePayload<string>, import("@reduxjs/toolkit/dist/tsHelpers").IfVoid<T, import("@reduxjs/toolkit").ActionCreatorWithoutPayload<string>, import("@reduxjs/toolkit/dist/tsHelpers").IfMaybeUndefined<T, import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<T, string>, import("@reduxjs/toolkit").ActionCreatorWithPayload<T, string>>>>>, alwaysRetrieve?: boolean | undefined) => () => Promise<T>;
+import { PayloadAction } from '@reduxjs/toolkit';
+/** @see {useReduxCachedValue} when RETRIEVED_VALUE === STORED_VALUE */
+declare const useReduxCachedValue: <RETRIEVED_VALUE, RETRIEVER_ARGS>(entity: string, retrieverService: (retrieverServiceArgs: RETRIEVER_ARGS) => Promise<RETRIEVED_VALUE>, reduxSelector: (state: any) => RETRIEVED_VALUE | undefined, reduxSetterAction: (value: RETRIEVED_VALUE, retrieverServiceArgs: RETRIEVER_ARGS) => PayloadAction<any>, selectedValuePredicate2Retrieve?: ((value: RETRIEVED_VALUE, args: RETRIEVER_ARGS) => boolean) | undefined, alwaysRetrieve?: boolean | undefined) => (retrieverServiceArgs: RETRIEVER_ARGS) => Promise<RETRIEVED_VALUE>;
+/** It will return a method that will call the retrieverService only when there are not storing values, or a condition on them is not more verified */
+export declare const useReduxCachedValueTranscoded: <RETRIEVED_VALUE, STORED_VALUE, RETRIEVER_ARGS>(entity: string, retrieverService: (retrieverServiceArgs: RETRIEVER_ARGS) => Promise<RETRIEVED_VALUE>, reduxSelector: (state: any) => STORED_VALUE | undefined, reduxSetterAction: (value: RETRIEVED_VALUE, retrieverServiceArgs: RETRIEVER_ARGS) => {
+    payload: STORED_VALUE;
+    type: string;
+}, selectedValue2RetrievedValue: (value: STORED_VALUE) => RETRIEVED_VALUE, selectedValuePredicate2Retrieve?: ((value: STORED_VALUE, args: RETRIEVER_ARGS) => boolean) | undefined, alwaysRetrieve?: boolean | undefined) => (retrieverServiceArgs: RETRIEVER_ARGS) => Promise<RETRIEVED_VALUE>;
 export default useReduxCachedValue;

package/hooks/useReduxCachedValue.js

@@ -1,29 +1,50 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.useReduxCachedValueTranscoded = void 0;
 const tslib_1 = require("tslib");
 const react_redux_1 = require("react-redux");
 const constants_1 = require("../utils/constants");
 const useLoading_1 = (0, tslib_1.__importDefault)(require("./useLoading"));
-/** It will return a method that only at the very first invocation it will call the retrieverService only the first time, storing the obtained values, and returning always cached values */
-const useReduxCachedValue = (entity, retrieverService, reduxSelector, reduxSetterAction, alwaysRetrieve) => {
+/** @see {useReduxCachedValue} when RETRIEVED_VALUE === STORED_VALUE */
+const useReduxCachedValue = (entity, retrieverService, reduxSelector, reduxSetterAction, selectedValuePredicate2Retrieve, alwaysRetrieve) => (0, exports.useReduxCachedValueTranscoded)(entity, retrieverService, reduxSelector, reduxSetterAction, (value) => value, selectedValuePredicate2Retrieve, alwaysRetrieve);
+/** It will return a method that will call the retrieverService only when there are not storing values, or a condition on them is not more verified */
+const useReduxCachedValueTranscoded = (
+/** The name of the entity, used just for logging purpose */
+entity, 
+/** The service that will retrieve the value */
+retrieverService, 
+/** The selector to read the value from redux */
+reduxSelector, 
+/** The action to store the new value */
+reduxSetterAction, 
+/** A function called to transform STORED_VALUE into RETRIEVED_VALUE and called when hitting the cache */
+selectedValue2RetrievedValue, 
+/** An optional predicate evaluated when reduxSelector returned some value in order to compare it against the retrieverServiceArgs and evaluate if retrieverService should be called again  */
+selectedValuePredicate2Retrieve, 
+/** If true, it will always retrieve and store the new value */
+alwaysRetrieve) => {
     const dispatch = (0, react_redux_1.useDispatch)();
     const entities = (0, react_redux_1.useSelector)(reduxSelector);
-    const setEntities = (value) => dispatch(reduxSetterAction(value));
+    const setEntities = (value, retrieverServiceArgs) => dispatch(reduxSetterAction(value, retrieverServiceArgs));
     const setLoading = (0, useLoading_1.default)(`${constants_1.LOADING_TASK_RETRIEVE_CACHED_VALUES}_${entity}`);
-    return () => {
-        if (alwaysRetrieve || !entities) {
+    return (retrieverServiceArgs) => {
+        if (alwaysRetrieve ||
+            !entities ||
+            (selectedValuePredicate2Retrieve &&
+                selectedValuePredicate2Retrieve(entities, retrieverServiceArgs))) {
             setLoading(true);
-            return retrieverService()
+            return retrieverService(retrieverServiceArgs)
                 .then((e) => {
-                setEntities(e);
+                setEntities(e, retrieverServiceArgs);
                 return e;
             })
                 .finally(() => setLoading(false));
         }
         else {
-            return new Promise((resolve) => resolve(entities));
+            return new Promise((resolve) => resolve(selectedValue2RetrievedValue(entities)));
         }
     };
 };
+exports.useReduxCachedValueTranscoded = useReduxCachedValueTranscoded;
 exports.default = useReduxCachedValue;
 //# sourceMappingURL=useReduxCachedValue.js.map

package/hooks/useReduxCachedValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"useReduxCachedValue.js","sourceRoot":"","sources":["../../src/lib/hooks/useReduxCachedValue.tsx"],"names":[],"mappings":";;;AACA,6CAAuD;AACvD,kDAAyE;AACzE,2EAAsC;AAEtC,4LAA4L;AAC5L,MAAM,mBAAmB,GAAG,CAC1B,MAAc,EACd,gBAAkC,EAClC,aAAgC,EAChC,iBAA0C,EAC1C,cAAwB,EACJ,EAAE;IACtB,MAAM,QAAQ,GAAG,IAAA,yBAAW,GAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,IAAA,yBAAW,EAAC,aAAa,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,CAAC,KAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IAErE,MAAM,UAAU,GAAG,IAAA,oBAAU,EAAC,GAAG,+CAAmC,IAAI,MAAM,EAAE,CAAC,CAAC;IAElF,OAAO,GAAe,EAAE;QACtB,IAAI,cAAc,IAAI,CAAC,QAAQ,EAAE;YAC/B,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO,gBAAgB,EAAE;iBACtB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACV,WAAW,CAAC,CAAC,CAAC,CAAC;gBACf,OAAO,CAAC,CAAC;YACX,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;SACrC;aAAM;YACL,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;SACpD;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,mBAAmB,CAAC"}
+{"version":3,"file":"useReduxCachedValue.js","sourceRoot":"","sources":["../../src/lib/hooks/useReduxCachedValue.tsx"],"names":[],"mappings":";;;;AACA,6CAAuD;AACvD,kDAAyE;AACzE,2EAAsC;AAEtC,uEAAuE;AACvE,MAAM,mBAAmB,GAAG,CAC1B,MAAc,EACd,gBAAoF,EACpF,aAA0D,EAC1D,iBAGuB,EACvB,+BAA2F,EAC3F,cAAwB,EAC8C,EAAE,CACxE,IAAA,qCAA6B,EAC3B,MAAM,EACN,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAChB,+BAA+B,EAC/B,cAAc,CACf,CAAC;AAEJ,sJAAsJ;AAC/I,MAAM,6BAA6B,GAAG;AAC3C,4DAA4D;AAC5D,MAAc;AACd,+CAA+C;AAC/C,gBAAoF;AACpF,gDAAgD;AAChD,aAAuD;AACvD,wCAAwC;AACxC,iBAGgC;AAChC,yGAAyG;AACzG,4BAAsE;AACtE,8LAA8L;AAC9L,+BAAwF;AACxF,+DAA+D;AAC/D,cAAwB,EAC8C,EAAE;IACxE,MAAM,QAAQ,GAAG,IAAA,yBAAW,GAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,IAAA,yBAAW,EAAC,aAAa,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,CAAC,KAAsB,EAAE,oBAAoC,EAAE,EAAE,CACnF,QAAQ,CAAC,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAE3D,MAAM,UAAU,GAAG,IAAA,oBAAU,EAAC,GAAG,+CAAmC,IAAI,MAAM,EAAE,CAAC,CAAC;IAElF,OAAO,CAAC,oBAAoC,EAA4B,EAAE;QACxE,IACE,cAAc;YACd,CAAC,QAAQ;YACT,CAAC,+BAA+B;gBAC9B,+BAA+B,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC,EAClE;YACA,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO,gBAAgB,CAAC,oBAAoB,CAAC;iBAC1C,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACV,WAAW,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;gBACrC,OAAO,CAAC,CAAC;YACX,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;SACrC;aAAM;YACL,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SAClF;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AA5CW,QAAA,6BAA6B,iCA4CxC;AAEF,kBAAe,mBAAmB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pagopa/selfcare-common-frontend",
   "description": "Shared React components for the pagopa selfcare project",
-  "version": "1.5.0",
+  "version": "1.5.4",
   "license": "MIT",
   "repository": "https://github.com/pagopa/selfcare-common-frontend",
   "author": "https://www.pagopa.gov.it",