feat(IT Wallet): [SIW-1824] Show alert if wallet instance is revoked

.env.local

@@ -101,3 +101,5 @@ ITW_IDP_HINT_TEST=YES
 ITW_IPZS_PRIVACY_URL='https://io.italia.it/informativa-ipzs'
 # ITW Documents on IO URL
 ITW_DOCUMENTS_ON_IO_URL='https://io.italia.it/documenti-su-io'
+# ITW Minimum Integrity Requirements FAQ URL
+ITW_MINIMUM_INTEGRITY_REQUIREMENTS='https://io.italia.it/documenti-su-io/faq/#n1_12

.env.production

@@ -101,3 +101,5 @@ ITW_IDP_HINT_TEST=NO
 ITW_IPZS_PRIVACY_URL='https://io.italia.it/informativa-ipzs'
 # ITW Documents on IO URL
 ITW_DOCUMENTS_ON_IO_URL='https://io.italia.it/documenti-su-io'
+# ITW Minimum Integrity Requirements FAQ URL
+ITW_MINIMUM_INTEGRITY_REQUIREMENTS='https://io.italia.it/documenti-su-io/faq/#n1_12

locales/en/index.yml

@@ -3539,6 +3539,20 @@ features:
         title: Dicci cosa ne pensi
         content: Raccontaci la tua esperienza con la funzionalità Documenti su IO.
         action: Inizia
+    walletInstanceRevoked:
+      alert:
+        cta: Scopri di più
+        closeButton: Chiudi
+        closeButtonAlt: Ho capito
+        revokedByWalletProvider: 
+          title: Documenti su IO è stata disattivata
+          content: Per verificare i requisiti richiesti per continuare a usare la funzionalità sul tuo dispositivo, premi "Scopri di più".
+        newWalletInstanceCreated:
+          title: Documenti su IO è stata disattivata su questo dispositivo
+          content: Puoi usare i tuoi documenti su IO su un solo dispositivo alla volta per ragioni di sicurezza.
+        revokedByUser:
+          title: Hai disattivato Documenti su IO
+          content: Se cambi idea, potrai riattivare Documenti su IO in futuro.
 support:
   ticketList:
     noTicket:

locales/it/index.yml

@@ -3539,6 +3539,20 @@ features:
         title: Dicci cosa ne pensi
         content: Raccontaci la tua esperienza con la funzionalità Documenti su IO.
         action: Inizia
+    walletInstanceRevoked:
+      alert:
+        cta: Scopri di più
+        closeButton: Chiudi
+        closeButtonAlt: Ho capito
+        revokedByWalletProvider: 
+          title: Documenti su IO è stata disattivata
+          content: Per verificare i requisiti richiesti per continuare a usare la funzionalità sul tuo dispositivo, premi "Scopri di più".
+        newWalletInstanceCreated:
+          title: Documenti su IO è stata disattivata su questo dispositivo
+          content: Puoi usare i tuoi documenti su IO su un solo dispositivo alla volta per ragioni di sicurezza.
+        revokedByUser:
+          title: Hai disattivato Documenti su IO
+          content: Se cambi idea, potrai riattivare Documenti su IO in futuro.
 support:
   ticketList:
     noTicket:

ts/config.ts

@@ -259,3 +259,8 @@ export const itwDocumentsOnIOUrl: string = pipe(
   t.string.decode,
   E.getOrElse(() => "https://io.italia.it/documenti-su-io")
 );
+export const itwMinIntegrityReqURL: string = pipe(
+  Config.ITW_MINIMUM_INTEGRITY_REQUIREMENTS,
+  t.string.decode,
+  E.getOrElse(() => "https://io.italia.it/documenti-su-io/faq/#n1_12")
+);

ts/features/common/store/reducers/__tests__/__snapshots__/index.test.ts.snap

@@ -138,6 +138,8 @@ exports[`featuresPersistor should match snapshot 1`] = `
     "preferences": {},
     "walletInstance": {
       "attestation": undefined,
+      "isRevoked": false,
+      "revocationReason": undefined,
     },
   },
   "landingBanners": {

ts/features/itwallet/common/store/reducers/__tests__/__snapshots__/index.test.ts.snap

@@ -25,6 +25,8 @@ exports[`itWalletReducer should match snapshot 1`] = `
   "preferences": {},
   "walletInstance": {
     "attestation": undefined,
+    "isRevoked": false,
+    "revocationReason": undefined,
   },
 }
 `;

ts/features/itwallet/common/utils/itwAttestationUtils.ts

@@ -7,6 +7,7 @@ import {
 import { itwWalletProviderBaseUrl } from "../../../../config";
 import { SessionToken } from "../../../../types/SessionToken";
 import { createItWalletFetch } from "../../api/client";
+import { RevocationReason } from "../../walletInstance/store/reducers";
 import { regenerateCryptoKey, WIA_KEYTAG } from "./itwCryptoContextUtils";
 import {
   generateIntegrityHardwareKeyTag,
@@ -91,3 +92,16 @@ export const getWalletInstanceStatus = (
     walletProviderBaseUrl: itwWalletProviderBaseUrl,
     appFetch: createItWalletFetch(itwWalletProviderBaseUrl, sessionToken)
   });
+
+/**
+ * Map an optional string `revocationReason` to a value of the `RevocationReason` enum.
+ * @param revocationReason - An optional string representing the reason for revocation.
+ * @returns A value of the `RevocationReason` enum if the string `revocationReason`
+ * matches one of the enum values, otherwise `undefined`.
+ */
+export const toRevocationReason = (
+  revocationReason?: string
+): RevocationReason | undefined =>
+  Object.values(RevocationReason).includes(revocationReason as RevocationReason)
+    ? (revocationReason as RevocationReason)
+    : undefined;

ts/features/itwallet/lifecycle/saga/checkWalletInstanceStateSaga.ts

@@ -8,6 +8,7 @@ import { ensureIntegrityServiceIsReady } from "../../common/utils/itwIntegrityUt
 import { itwIntegrityKeyTagSelector } from "../../issuance/store/selectors";
 import { itwLifecycleIsOperationalOrValid } from "../store/selectors";
 import { itwIntegritySetServiceIsReady } from "../../issuance/store/actions";
+import { itwUpdateWalletInstanceStatus } from "../../walletInstance/store/actions";
 import { handleWalletInstanceResetSaga } from "./handleWalletInstanceResetSaga";
 
 export function* getStatusOrResetWalletInstance(integrityKeyTag: string) {
@@ -20,6 +21,9 @@ export function* getStatusOrResetWalletInstance(integrityKeyTag: string) {
     sessionToken
   );
 
+  // Update wallet instance status
+  yield* put(itwUpdateWalletInstanceStatus(walletInstanceStatus));
+
   if (walletInstanceStatus.is_revoked) {
     yield* call(handleWalletInstanceResetSaga);
   }

ts/features/itwallet/walletInstance/hook/useItwWalletInstanceRevocationAlert.ts

@@ -0,0 +1,107 @@
+import { Alert, AlertButton, Linking } from "react-native";
+import React from "react";
+import { IOToast } from "@pagopa/io-app-design-system";
+import { RevocationReason } from "../store/reducers";
+import I18n from "../../../../i18n";
+import { itwMinIntegrityReqURL } from "../../../../config";
+
+const closeButtonText = I18n.t(
+  "features.itWallet.walletInstanceRevoked.alert.closeButton"
+);
+const alertCtaText = I18n.t(
+  "features.itWallet.walletInstanceRevoked.alert.cta"
+);
+
+/**
+ * Hook to monitor wallet instance status and display alerts if revoked.
+ * @param walletInstanceStatus - The status of the wallet instance, including whether it is revoked and the reason for revocation.
+ */
+export const useItwWalletInstanceRevocationAlert = (walletInstanceStatus: {
+  isRevoked: boolean;
+  revocationReason?: RevocationReason;
+}) => {
+  React.useEffect(() => {
+    if (walletInstanceStatus.isRevoked) {
+      showWalletRevocationAlert(walletInstanceStatus.revocationReason);
+    }
+  }, [walletInstanceStatus]);
+};
+
+/**
+ * Displays an alert based on the revocation reason.
+ */
+const showWalletRevocationAlert = (revocationReason?: RevocationReason) => {
+  switch (revocationReason) {
+    case RevocationReason.CERTIFICATE_REVOKED_BY_ISSUER:
+      showAlert(
+        I18n.t(
+          "features.itWallet.walletInstanceRevoked.alert.revokedByWalletProvider.title"
+        ),
+        I18n.t(
+          "features.itWallet.walletInstanceRevoked.alert.revokedByWalletProvider.content"
+        ),
+        [
+          { text: closeButtonText },
+          {
+            text: alertCtaText,
+            onPress: () => {
+              Linking.openURL(itwMinIntegrityReqURL).catch(() => {
+                IOToast.error(I18n.t("global.genericError"));
+              });
+            }
+          }
+        ]
+      );
+      break;
+
+    case RevocationReason.NEW_WALLET_INSTANCE_CREATED:
+      showAlert(
+        I18n.t(
+          "features.itWallet.walletInstanceRevoked.alert.newWalletInstanceCreated.title"
+        ),
+        I18n.t(
+          "features.itWallet.walletInstanceRevoked.alert.newWalletInstanceCreated.content"
+        ),
+        [
+          { text: closeButtonText },
+          {
+            text: alertCtaText,
+            onPress: () => {
+              // TODO: Add the correct URL
+              Linking.openURL("").catch(() => {
+                IOToast.error(I18n.t("global.genericError"));
+              });
+            }
+          }
+        ]
+      );
+      break;
+    case RevocationReason.REVOKED_BY_USER:
+      showAlert(
+        I18n.t(
+          "features.itWallet.walletInstanceRevoked.alert.revokedByUser.title"
+        ),
+        I18n.t(
+          "features.itWallet.walletInstanceRevoked.alert.revokedByUser.content"
+        ),
+        [
+          {
+            text: I18n.t(
+              "features.itWallet.walletInstanceRevoked.alert.closeButtonAlt"
+            )
+          }
+        ]
+      );
+      break;
+    default:
+      break;
+  }
+};
+
+const showAlert = (
+  title: string,
+  message: string,
+  buttons: Array<AlertButton> = [{ text: closeButtonText }]
+) => {
+  Alert.alert(title, message, buttons);
+};

ts/features/itwallet/walletInstance/store/actions/index.ts

@@ -1,3 +1,4 @@
+import { WalletInstanceData } from "@pagopa/io-react-native-wallet/lib/typescript/client/generated/wallet-provider";
 import { ActionType, createStandardAction } from "typesafe-actions";
 
 /**
@@ -7,6 +8,13 @@ export const itwWalletInstanceAttestationStore = createStandardAction(
   "ITW_WALLET_INSTANCE_ATTESTATION_STORE"
 )<string>();
 
-export type ItwWalletInstanceActions = ActionType<
-  typeof itwWalletInstanceAttestationStore
->;
+/**
+ * This action update the Wallet Instance Status
+ */
+export const itwUpdateWalletInstanceStatus = createStandardAction(
+  "ITW_WALLET_INSTANCE__STATUS_UPDATE"
+)<WalletInstanceData>();
+
+export type ItwWalletInstanceActions =
+  | ActionType<typeof itwWalletInstanceAttestationStore>
+  | ActionType<typeof itwUpdateWalletInstanceStatus>;

ts/features/itwallet/walletInstance/store/reducers/index.ts

@@ -1,21 +1,37 @@
 import * as O from "fp-ts/lib/Option";
-import { flow } from "fp-ts/lib/function";
+import { flow, pipe } from "fp-ts/lib/function";
 import { PersistConfig, persistReducer } from "redux-persist";
 import { createSelector } from "reselect";
 import { getType } from "typesafe-actions";
 import { Action } from "../../../../../store/actions/types";
 import { GlobalState } from "../../../../../store/reducers/types";
 import itwCreateSecureStorage from "../../../common/store/storages/itwSecureStorage";
-import { isWalletInstanceAttestationValid } from "../../../common/utils/itwAttestationUtils";
+import {
+  isWalletInstanceAttestationValid,
+  toRevocationReason
+} from "../../../common/utils/itwAttestationUtils";
 import { itwLifecycleStoresReset } from "../../../lifecycle/store/actions";
-import { itwWalletInstanceAttestationStore } from "../actions";
+import {
+  itwWalletInstanceAttestationStore,
+  itwUpdateWalletInstanceStatus
+} from "../actions";
+
+export enum RevocationReason {
+  CERTIFICATE_REVOKED_BY_ISSUER = "CERTIFICATE_REVOKED_BY_ISSUER",
+  NEW_WALLET_INSTANCE_CREATED = "NEW_WALLET_INSTANCE_CREATED",
+  REVOKED_BY_USER = "REVOKED_BY_USER"
+}
 
 export type ItwWalletInstanceState = {
   attestation: string | undefined;
+  isRevoked: boolean;
+  revocationReason?: RevocationReason;
 };
 
 export const itwWalletInstanceInitialState: ItwWalletInstanceState = {
-  attestation: undefined
+  attestation: undefined,
+  isRevoked: false,
+  revocationReason: undefined
 };
 
 const CURRENT_REDUX_ITW_WALLET_INSTANCE_STORE_VERSION = -1;
@@ -27,10 +43,19 @@ const reducer = (
   switch (action.type) {
     case getType(itwWalletInstanceAttestationStore): {
       return {
+        ...state,
         attestation: action.payload
       };
     }
 
+    case getType(itwUpdateWalletInstanceStatus): {
+      return {
+        ...state,
+        isRevoked: action.payload.is_revoked,
+        revocationReason: toRevocationReason(action.payload.revocation_reason)
+      };
+    }
+
     case getType(itwLifecycleStoresReset):
       return { ...itwWalletInstanceInitialState };
 
@@ -62,4 +87,19 @@ export const itwIsWalletInstanceAttestationValidSelector = createSelector(
   )
 );
 
+/* Selector to get the wallet instance status */
+export const itwWalletInstanceStatusSelector = createSelector(
+  (state: GlobalState) => state.features.itWallet.walletInstance,
+  walletInstance =>
+    pipe(
+      O.fromNullable(walletInstance.isRevoked),
+      O.filter(Boolean),
+      O.map(() => ({
+        isRevoked: true,
+        revocationReason: walletInstance.revocationReason
+      })),
+      O.getOrElse(() => ({ isRevoked: false }))
+    )
+);
+
 export default persistedReducer;

ts/features/wallet/components/WalletCardsContainer.tsx

@@ -33,6 +33,8 @@ import {
 import { WalletCardCategoryFilter } from "../types";
 import { paymentsWalletUserMethodsSelector } from "../../payments/wallet/store/selectors";
 import { cgnDetailSelector } from "../../bonus/cgn/store/reducers/details";
+import { itwWalletInstanceStatusSelector } from "../../itwallet/walletInstance/store/reducers";
+import { useItwWalletInstanceRevocationAlert } from "../../itwallet/walletInstance/hook/useItwWalletInstanceRevocationAlert";
 import { WalletCardsCategoryContainer } from "./WalletCardsCategoryContainer";
 import { WalletCardsCategoryRetryErrorBanner } from "./WalletCardsCategoryRetryErrorBanner";
 import { WalletCardSkeleton } from "./WalletCardSkeleton";
@@ -46,6 +48,9 @@ const WalletCardsContainer = () => {
   const selectedCategory = useIOSelector(selectWalletCategoryFilter);
   const paymentMethodsStatus = useIOSelector(paymentsWalletUserMethodsSelector);
   const cgnStatus = useIOSelector(cgnDetailSelector);
+  const walletInstanceStatus = useIOSelector(itwWalletInstanceStatusSelector);
+
+  useItwWalletInstanceRevocationAlert(walletInstanceStatus);
 
   if (isLoading && cards.length === 0) {
     return (