@redacto.io/consent-sdk-react 3.5.0 → 4.0.0

package/src/RedactoNoticeConsent/components/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Consent SDK Components
+ * 
+ * Export reusable components for the consent flow.
+ */
+
+export { DigiLockerCallback } from "./DigiLockerCallback";

package/src/RedactoNoticeConsent/injectStyles.ts

@@ -133,6 +133,17 @@ export const injectCheckboxStyles = () => {
       outline: 3px solid #FFF9C4 !important;
       outline-offset: 2px !important;
     }
+
+    /* Spinner animation for verification screens */
+    @keyframes spin {
+      from { transform: rotate(0deg); }
+      to { transform: rotate(360deg); }
+    }
+
+    /* DigiLocker callback retry button hover */
+    .redacto-dl-retry-btn:hover {
+      background-color: #2563eb !important;
+    }
   `;
 
   document.head.appendChild(style);

package/src/RedactoNoticeConsent/services/storage.ts

@@ -0,0 +1,122 @@
+/**
+ * Session Storage Service
+ * 
+ * Handles state persistence for consent flow during DigiLocker redirects.
+ * Uses sessionStorage to maintain state across page navigations.
+ */
+
+import type { PersistedConsentState } from "../api/types";
+
+const STORAGE_KEY = "redacto_consent_sdk_state";
+const STATE_EXPIRY_MS = 30 * 60 * 1000; // 30 minutes
+
+/**
+ * Check if code is running in browser environment
+ */
+const isBrowser = (): boolean => {
+  return typeof window !== "undefined" && typeof window.sessionStorage !== "undefined";
+};
+
+/**
+ * Save consent flow state to sessionStorage
+ */
+export const saveConsentState = (state: PersistedConsentState): void => {
+  if (!isBrowser()) {
+    console.warn("SessionStorage not available - state not persisted");
+    return;
+  }
+
+  try {
+    const stateWithTimestamp = {
+      ...state,
+      timestamp: new Date().toISOString(),
+    };
+    sessionStorage.setItem(STORAGE_KEY, JSON.stringify(stateWithTimestamp));
+  } catch (error) {
+    console.error("Failed to save consent state:", error);
+  }
+};
+
+/**
+ * Retrieve consent flow state from sessionStorage
+ * Returns null if state doesn't exist or is expired
+ */
+export const getConsentState = (): PersistedConsentState | null => {
+  if (!isBrowser()) {
+    return null;
+  }
+
+  try {
+    const savedState = sessionStorage.getItem(STORAGE_KEY);
+    if (!savedState) {
+      return null;
+    }
+
+    const parsed: PersistedConsentState = JSON.parse(savedState);
+
+    // Check if state is expired
+    const stateAge = Date.now() - new Date(parsed.timestamp).getTime();
+    if (stateAge > STATE_EXPIRY_MS) {
+      clearConsentState();
+      return null;
+    }
+
+    return parsed;
+  } catch (error) {
+    console.error("Failed to get consent state:", error);
+    return null;
+  }
+};
+
+/**
+ * Clear consent flow state from sessionStorage
+ */
+export const clearConsentState = (): void => {
+  if (!isBrowser()) {
+    return;
+  }
+
+  try {
+    sessionStorage.removeItem(STORAGE_KEY);
+  } catch (error) {
+    console.error("Failed to clear consent state:", error);
+  }
+};
+
+/**
+ * Update specific fields in the persisted consent state
+ */
+export const updateConsentState = (updates: Partial<PersistedConsentState>): void => {
+  const currentState = getConsentState();
+  if (currentState) {
+    saveConsentState({
+      ...currentState,
+      ...updates,
+      timestamp: new Date().toISOString(),
+    });
+  }
+};
+
+/**
+ * Check if there's a pending verification to resume
+ */
+export const hasPendingVerification = (): boolean => {
+  const state = getConsentState();
+  return state !== null && state.flowState === "digilocker-pending";
+};
+
+/**
+ * Get verification result from persisted state
+ */
+export const getVerificationResult = (): "pending" | "verified" | "failed" | "in_progress" | "expired" | null => {
+  const state = getConsentState();
+  return state?.verificationResult ?? null;
+};
+
+/**
+ * Get verification reference from persisted state (after successful verification)
+ */
+export const getVerificationReference = (): string | null => {
+  const state = getConsentState();
+  return state?.verificationReference ?? null;
+};

package/src/RedactoNoticeConsent/types.ts

@@ -13,6 +13,8 @@ export type Props = Readonly<{
   onError?: (error: Error) => void;
   applicationId?: string;
   validateAgainst?: "all" | "required";
+  digilockerMode?: "popup" | "redirect"; // Default: "redirect" (full page redirect - required for DigiLocker)
+  digilockerCallbackUrl?: string; // Default: "/digilocker-callback"
   includeFullyConsentedData?: boolean;
   reviewModeButtonText?: string;
 }>;

package/src/index.ts

@@ -1,2 +1,12 @@
 export { default as RedactoNoticeConsent } from "./RedactoNoticeConsent";
 export { default as RedactoNoticeConsentInline } from "./RedactoNoticeConsentInline";
+
+// Guardian Verification Components
+export { DigiLockerCallback } from "./RedactoNoticeConsent/components/DigiLockerCallback";
+
+// Types for Guardian Verification
+export type {
+  DigiLockerCallbackProps,
+  ConsentFlowState,
+  GuardianVerificationErrorCode,
+} from "./RedactoNoticeConsent/api/types";