@redacto.io/consent-sdk-react 5.2.0 → 5.3.0

package/dist/index.mjs

@@ -3,6 +3,64 @@ import { useCallback, useEffect as useEffect2, useMemo, useRef, useState as useS
 
 // src/RedactoNoticeConsent/api/index.ts
 import { jwtDecode } from "jwt-decode";
+
+// src/shared/api-errors.ts
+var ApiError = class extends Error {
+  constructor(opts) {
+    super(opts.message);
+    this.name = "ApiError";
+    this.status = opts.status;
+    this.code = opts.code;
+  }
+};
+function statusFallback(status) {
+  if (status === 401) {
+    return "Your session has expired. Please request a new access link.";
+  }
+  if (status === 403) {
+    return "You do not have access to this resource.";
+  }
+  if (status >= 500) {
+    return "Something went wrong on our end. Please try again later.";
+  }
+  return void 0;
+}
+function extractFromDetail(detail) {
+  var _a;
+  if (typeof detail === "string") {
+    return { message: detail };
+  }
+  if (Array.isArray(detail)) {
+    return {};
+  }
+  if (detail && typeof detail === "object") {
+    const obj = detail;
+    return { message: (_a = obj.message) != null ? _a : obj.detail, code: obj.error_code };
+  }
+  return {};
+}
+async function parseApiError(response, fallbackMessage) {
+  var _a, _b, _c, _d;
+  let body;
+  let parsedBody = false;
+  try {
+    body = await response.json();
+    parsedBody = true;
+  } catch {
+    body = void 0;
+  }
+  const fromDetail = extractFromDetail(body == null ? void 0 : body.detail);
+  const serverMessage = (_a = body == null ? void 0 : body.message) != null ? _a : fromDetail.message;
+  const message = (_b = serverMessage != null ? serverMessage : parsedBody ? statusFallback(response.status) : void 0) != null ? _b : fallbackMessage;
+  const code = (_d = (_c = body == null ? void 0 : body.error_code) != null ? _c : fromDetail.code) != null ? _d : void 0;
+  return new ApiError({
+    status: response.status,
+    code,
+    message
+  });
+}
+
+// src/RedactoNoticeConsent/api/index.ts
 var BASE_URL = "https://api.redacto.io/consent";
 var apiCache = /* @__PURE__ */ new Map();
 var CACHE_TTL = 5 * 60 * 1e3;
@@ -78,21 +136,10 @@ var fetchConsentContent = async ({
     signal
   });
   if (!response.ok) {
-    let errorMessage = `Failed to fetch consent content: ${response.status} ${response.statusText}`;
-    if (response.status === 401) {
-      errorMessage = "Unauthorized: Invalid or expired token";
-    } else if (response.status === 403) {
-      errorMessage = "Forbidden: Access denied";
-    } else if (response.status === 404) {
-      errorMessage = "Notice not found";
-    } else if (response.status === 409) {
-      errorMessage = "User has already provided consent";
-    } else if (response.status >= 500) {
-      errorMessage = "Server error: Please try again later";
-    }
-    const error = new Error(errorMessage);
-    error.status = response.status;
-    throw error;
+    throw await parseApiError(
+      response,
+      "Could not load the consent notice. Please try again."
+    );
   }
   const data = await response.json();
   if (validate_against === "all" && !specific_uuid) {
@@ -162,26 +209,10 @@ var submitConsentEvent = async ({
     }
   );
   if (!response.ok) {
-    let errorMessage = `Failed to submit consent: ${response.status} ${response.statusText}`;
-    if (response.status === 400) {
-      try {
-        const errorData = await response.json();
-        errorMessage = errorData.message || "Invalid request data";
-      } catch {
-        errorMessage = "Invalid request data";
-      }
-    } else if (response.status === 401) {
-      errorMessage = "Unauthorized: Invalid or expired token";
-    } else if (response.status === 403) {
-      errorMessage = "Forbidden: Access denied";
-    } else if (response.status === 404) {
-      errorMessage = "Notice not found";
-    } else if (response.status >= 500) {
-      errorMessage = "Server error: Please try again later";
-    }
-    const error = new Error(errorMessage);
-    error.status = response.status;
-    throw error;
+    throw await parseApiError(
+      response,
+      "Could not submit your consent. Please try again."
+    );
   }
   apiCache.clear();
 };
@@ -214,19 +245,10 @@ var fetchTTSAudioUrls = async ({
     signal
   });
   if (!response.ok) {
-    let errorMessage = `Failed to fetch TTS audio URLs: ${response.status} ${response.statusText}`;
-    if (response.status === 401) {
-      errorMessage = "Unauthorized: Invalid or expired token";
-    } else if (response.status === 403) {
-      errorMessage = "Forbidden: Access denied";
-    } else if (response.status === 404) {
-      errorMessage = "Notice or audio not found";
-    } else if (response.status >= 500) {
-      errorMessage = "Server error: Please try again later";
-    }
-    const error = new Error(errorMessage);
-    error.status = response.status;
-    throw error;
+    throw await parseApiError(
+      response,
+      "Could not load audio narration. Please try again."
+    );
   }
   const data = await response.json();
   return data;
@@ -288,31 +310,10 @@ var initiateGuardianVerification = async ({
       }
     );
     if (!response.ok) {
-      let errorMessage = `Failed to initiate verification: ${response.status} ${response.statusText}`;
-      if (response.status === 400) {
-        try {
-          const errorData = await response.json();
-          errorMessage = errorData.message || "Invalid request data";
-        } catch {
-          errorMessage = "Invalid request data";
-        }
-      } else if (response.status === 401) {
-        errorMessage = "Unauthorized: Invalid or expired token";
-      } else if (response.status === 404) {
-        errorMessage = "Organization or workspace not found";
-      } else if (response.status === 422) {
-        try {
-          const errorData = await response.json();
-          errorMessage = errorData.message || "Validation error: Please check your input";
-        } catch {
-          errorMessage = "Validation error: Please check your input";
-        }
-      } else if (response.status >= 500) {
-        errorMessage = "Server error: Please try again later";
-      }
-      const error = new Error(errorMessage);
-      error.status = response.status;
-      throw error;
+      throw await parseApiError(
+        response,
+        "Could not start guardian verification. Please try again."
+      );
     }
     const responseData = await response.json();
     const detail = responseData.detail || responseData;
@@ -346,7 +347,7 @@ var verifyGuardianStatus = async ({
   sessionToken,
   signal
 }) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
+  var _a, _b, _c, _d, _e, _f, _g;
   if (!accessToken || !sessionToken) {
     throw new Error("accessToken and sessionToken are required");
   }
@@ -374,37 +375,21 @@ var verifyGuardianStatus = async ({
     }
   );
   if (!response.ok) {
-    let errorMessage = `Failed to check verification status: ${response.status} ${response.statusText}`;
-    if (response.status === 400) {
-      try {
-        const errorData = await response.json();
-        errorMessage = errorData.message || ((_a = errorData.detail) == null ? void 0 : _a.message) || "Invalid session token";
-      } catch {
-        errorMessage = "Invalid session token";
-      }
-    } else if (response.status === 401) {
-      errorMessage = "Unauthorized: Invalid or expired token";
-    } else if (response.status === 404) {
-      errorMessage = "Verification session not found or expired. Please restart the verification process.";
-    } else if (response.status === 410) {
-      errorMessage = "Verification session has expired. Please restart the verification process.";
-    } else if (response.status >= 500) {
-      errorMessage = "Server error: Please try again later";
-    }
-    const error = new Error(errorMessage);
-    error.status = response.status;
-    throw error;
+    throw await parseApiError(
+      response,
+      "Could not check verification status. Please try again."
+    );
   }
   const responseData = await response.json();
   const detail = responseData.detail || responseData;
   return {
-    status: (_b = detail.status) != null ? _b : "in_progress",
-    guardian_info_uuid: (_c = detail.guardian_info_uuid) != null ? _c : null,
-    verification_reference: (_d = detail.verification_reference) != null ? _d : null,
-    guardian_details: (_e = detail.guardian_details) != null ? _e : null,
-    error: (_f = detail.error) != null ? _f : null,
-    error_code: (_g = detail.error_code) != null ? _g : null,
-    can_retry: (_h = detail.can_retry) != null ? _h : true
+    status: (_a = detail.status) != null ? _a : "in_progress",
+    guardian_info_uuid: (_b = detail.guardian_info_uuid) != null ? _b : null,
+    verification_reference: (_c = detail.verification_reference) != null ? _c : null,
+    guardian_details: (_d = detail.guardian_details) != null ? _d : null,
+    error: (_e = detail.error) != null ? _e : null,
+    error_code: (_f = detail.error_code) != null ? _f : null,
+    can_retry: (_g = detail.can_retry) != null ? _g : true
   };
 };
 
@@ -2901,7 +2886,7 @@ var RedactoNoticeConsent = ({
         return;
       }
       const err = error;
-      const message = err.status === 500 ? "An error occurred while submitting your consent. Please try again later." : err.message || "Failed to submit consent. Please try again.";
+      const message = err.message || "Failed to submit consent. Please try again.";
       setErrorMessage(message);
       onError == null ? void 0 : onError(error);
     } finally {
@@ -3323,20 +3308,12 @@ var RedactoNoticeConsent = ({
   }, []);
   const availableLanguages = useMemo(() => {
     if (!content) return [language];
-    const languages = ["English"];
+    const pinned = ["English"];
     if (content.default_language && content.default_language !== "English" && content.default_language !== "en") {
-      languages.push(content.default_language);
+      pinned.push(content.default_language);
     }
-    if (content.supported_languages_and_translations) {
-      Object.keys(content.supported_languages_and_translations).forEach(
-        (lang) => {
-          if (!languages.includes(lang)) {
-            languages.push(lang);
-          }
-        }
-      );
-    }
-    return languages;
+    const rest = content.supported_languages_and_translations ? Object.keys(content.supported_languages_and_translations).filter((lang) => !pinned.includes(lang)).sort((a, b) => a.localeCompare(b, "en")) : [];
+    return [...pinned, ...rest];
   }, [content, language]);
   const getLanguageCode = useCallback(
     (displayLanguage) => {
@@ -4581,40 +4558,27 @@ var fetchConsentContent2 = async ({
   baseUrl,
   specific_uuid
 }) => {
-  try {
-    const apiBaseUrl = baseUrl || BASE_URL2;
-    const url = new URL(
-      `${apiBaseUrl}/public/organisations/${org_uuid}/workspaces/${workspace_uuid}/notices/get-notice/${notice_uuid}`
-    );
-    if (specific_uuid) {
-      url.searchParams.append("specific_uuid", specific_uuid);
-    }
-    const response = await fetch(url.toString(), {
-      method: "GET",
-      headers: {
-        "Content-Type": "application/json"
-      }
-    });
-    if (response.status === 401) {
-      const error = new Error("Unauthorized");
-      error.status = 401;
-      throw error;
-    }
-    if (response.status === 409) {
-      const error = new Error("User has already provided consent");
-      error.status = 409;
-      throw error;
-    }
-    if (!response.ok) {
-      throw new Error(
-        `Failed to fetch consent content: ${response.statusText}`
-      );
+  const apiBaseUrl = baseUrl || BASE_URL2;
+  const url = new URL(
+    `${apiBaseUrl}/public/organisations/${org_uuid}/workspaces/${workspace_uuid}/notices/get-notice/${notice_uuid}`
+  );
+  if (specific_uuid) {
+    url.searchParams.append("specific_uuid", specific_uuid);
+  }
+  const response = await fetch(url.toString(), {
+    method: "GET",
+    headers: {
+      "Content-Type": "application/json"
     }
-    const data = await response.json();
-    return data;
-  } catch (error) {
-    throw error;
+  });
+  if (!response.ok) {
+    throw await parseApiError(
+      response,
+      "Could not load the consent notice. Please try again."
+    );
   }
+  const data = await response.json();
+  return data;
 };
 var submitConsentEvent2 = async ({
   org_uuid,
@@ -4626,67 +4590,44 @@ var submitConsentEvent2 = async ({
   declined,
   meta_data
 }) => {
-  var _a, _b;
-  try {
-    const apiBaseUrl = baseUrl || BASE_URL2;
-    const payload = {
-      notice_uuid: noticeUuid,
-      purposes: purposes.map((purpose) => {
-        if (!purpose.uuid) {
-          throw new Error(`Invalid purpose data: missing uuid`);
-        }
-        const dataElements = purpose.data_elements.filter((element) => element.enabled).map((element) => ({
-          uuid: element.uuid,
-          selected: element.required ? true : Boolean(element.selected)
-        }));
-        return {
-          purpose_uuid: purpose.uuid,
-          selected: Boolean(purpose.selected),
-          data_elements: dataElements.length > 0 ? dataElements : void 0
-        };
-      }),
-      select_all_mandatory: false,
-      source: "WEB",
-      declined,
-      meta_data
-    };
-    const response = await fetch(
-      `${apiBaseUrl}/public/organisations/${org_uuid}/workspaces/${workspace_uuid}/submit-consent`,
-      {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${accessToken}`,
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(payload)
-      }
-    );
-    if (!response.ok) {
-      let errorData;
-      try {
-        errorData = await response.json();
-      } catch {
-        errorData = { message: response.statusText };
-      }
-      if (response.status === 409) {
-        const error2 = new Error(
-          ((_a = errorData.detail) == null ? void 0 : _a.message) || errorData.message || "User has already provided consent"
-        );
-        error2.status = 409;
-        error2.code = errorData.code || 409;
-        error2.detail = errorData.detail;
-        throw error2;
+  const apiBaseUrl = baseUrl || BASE_URL2;
+  const payload = {
+    notice_uuid: noticeUuid,
+    purposes: purposes.map((purpose) => {
+      if (!purpose.uuid) {
+        throw new Error(`Invalid purpose data: missing uuid`);
       }
-      const error = new Error(
-        ((_b = errorData.detail) == null ? void 0 : _b.message) || errorData.message || `Failed to submit consent event: ${response.statusText}`
-      );
-      error.status = response.status;
-      error.code = errorData.code;
-      error.detail = errorData.detail;
-      throw error;
+      const dataElements = purpose.data_elements.filter((element) => element.enabled).map((element) => ({
+        uuid: element.uuid,
+        selected: element.required ? true : Boolean(element.selected)
+      }));
+      return {
+        purpose_uuid: purpose.uuid,
+        selected: Boolean(purpose.selected),
+        data_elements: dataElements.length > 0 ? dataElements : void 0
+      };
+    }),
+    select_all_mandatory: false,
+    source: "WEB",
+    declined,
+    meta_data
+  };
+  const response = await fetch(
+    `${apiBaseUrl}/public/organisations/${org_uuid}/workspaces/${workspace_uuid}/submit-consent`,
+    {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(payload)
     }
-  } catch (error) {
-    throw error;
+  );
+  if (!response.ok) {
+    throw await parseApiError(
+      response,
+      "Could not submit your consent. Please try again."
+    );
   }
 };
 
@@ -5359,7 +5300,7 @@ var RedactoConsentInlineComponent = ({
         hasSubmittedRef.current = false;
       } catch (error) {
         const err = error;
-        const message = err.status === 500 ? "An error occurred while submitting your consent. Please try again later." : err.message || "Failed to submit consent. Please try again.";
+        const message = err.message || "Failed to submit consent. Please try again.";
         setErrorMessage(message);
         hasSubmittedRef.current = false;
         throw error;
@@ -6072,6 +6013,7 @@ var DigiLockerCallback = ({
   ] });
 };
 export {
+  ApiError,
   DigiLockerCallback,
   RedactoNoticeConsent,
   RedactoConsentInline as RedactoNoticeConsentInline

package/dist/privacy-center.d.mts

@@ -102,6 +102,30 @@ declare function createConsentClient(baseUrl: string): {
      * Get document info/download URL for a case document (privacy center)
      */
     getCaseDocument(baseRequest: BaseRequest, caseUuid: string, documentUuid: string, authToken?: string): Promise<MessageDocument>;
+    /**
+     * List notifications (paginated, with filters)
+     */
+    getNotifications(baseRequest: BaseRequest, params?: NotificationQueryParams, authToken?: string): Promise<NotificationListResponse>;
+    /**
+     * Get notification summary (aggregated counts only)
+     */
+    getNotificationSummary(baseRequest: BaseRequest, authToken?: string): Promise<NotificationSummary>;
+    /**
+     * Get unread notification count (lightweight, for badge)
+     */
+    getUnreadCount(baseRequest: BaseRequest, authToken?: string): Promise<UnreadCountResponse>;
+    /**
+     * Mark a single notification as read
+     */
+    markNotificationRead(baseRequest: BaseRequest, notificationUuid: string, authToken?: string): Promise<NotificationActionResponse>;
+    /**
+     * Mark all notifications as read
+     */
+    markAllNotificationsRead(baseRequest: BaseRequest, authToken?: string): Promise<NotificationActionResponse>;
+    /**
+     * Acknowledge a notification (sets is_read and is_acknowledged to true)
+     */
+    acknowledgeNotification(baseRequest: BaseRequest, notificationUuid: string, authToken?: string): Promise<NotificationActionResponse>;
 };
 
 type Workspace = {
@@ -440,8 +464,61 @@ type UploadDocumentResponse = {
     allow_ai_processing: boolean;
     metadata: Record<string, string> | null;
 };
+type NotificationType = 'guardian_verification_request' | 'consent_expiry_warning' | 'new_consent_notice' | 'consent_withdrawal_confirmation' | 'data_request_status_update' | 'case_message' | 'grievance_status_update' | 'consent_regrant_prompt';
+type NotificationCategory = 'consent' | 'request' | 'system';
+type NotificationCTA = {
+    label: string;
+    style: 'primary' | 'secondary' | 'danger';
+    action_type: 'link' | 'acknowledge';
+    url?: string;
+};
+type Notification = {
+    uuid: string;
+    notification_type: NotificationType;
+    category: NotificationCategory;
+    title: string;
+    description: string;
+    is_read: boolean;
+    is_acknowledged: boolean;
+    source_type: string;
+    source_uuid: string | null;
+    request_type: string;
+    request_type_display?: string | null;
+    status_label: string;
+    status_label_display?: string | null;
+    ctas: NotificationCTA[];
+    created_at: string;
+};
+type NotificationSummary = {
+    total: number;
+    unread: number;
+    action_needed: number;
+    acknowledged: number;
+};
+type NotificationListResponse = {
+    data: Notification[];
+    total: number;
+    skip: number;
+    limit: number;
+    summary: NotificationSummary | null;
+};
+type UnreadCountResponse = {
+    count: number;
+};
+type NotificationActionResponse = {
+    message: string;
+};
+type NotificationQueryParams = {
+    category?: NotificationCategory;
+    notification_type?: NotificationType;
+    is_read?: boolean;
+    skip?: number;
+    limit?: number;
+    include_summary?: boolean;
+    language?: string;
+};
 
-type InternalPage = 'consent-manager' | 'form' | 'activity' | 'case-details';
+type InternalPage = 'consent-manager' | 'form' | 'activity' | 'case-details' | 'notifications';
 interface NavigationContextType {
     currentPage: InternalPage;
     navigateTo: (page: InternalPage) => void;
@@ -485,6 +562,8 @@ declare function PrivacyCenterActivityPage(): react_jsx_runtime.JSX.Element;
 
 declare const PrivacyCenterCaseDetailsPage: () => react_jsx_runtime.JSX.Element | null;
 
+declare const NotificationsPage: () => react_jsx_runtime.JSX.Element;
+
 type AuthContextValue = Readonly<{
     accessToken: string;
     refreshToken: string;
@@ -646,4 +725,4 @@ declare const useAuth: () => AuthContextValue;
  */
 declare const injectPCStyles: () => void;
 
-export { type Activity, type ActivityBadgeStatus$1 as ActivityBadgeStatus, type ActivityDetail, type ActivityResponse, type ApiFetchOptions, type ApiResponse, type AuthContext, AuthProvider, type BaseRequest, BaseUrlProvider, type CaseHistoryDetail, type CaseHistoryResponse, type CaseRequest, type ConsentAction, type ConsentDataElement, type ConsentHistoryStatusSummary, ConsentStatusEnum, type CreateCaseResponse, type DataElement, type FetchOrgParams, type FormData, type FormDataResponse, type GrievanceOptions, type GrievanceTypeElement, GrievanceTypeEnum, type GrievanceValue, type InternalPage, type ManageConsentParams, type ManageConsentResponse, NavigationProvider, type NominatedPurposesGroup, type NominationData, type NominatorInfo, type OrganizationDetail, type OrganizationResponse, type OtpResponse, type OtpVerificationResponse, type Pagination, PrivacyCenterActivityPage, PrivacyCenterCaseDetailsPage, PrivacyCenterConsentManagerPage, PrivacyCenterFormPage, PrivacyCenterHomePage, PrivacyCenterLayout, type ProductConsentHistoryGroup, type Purpose, type RawPurposeWrapper, RedactoPrivacyCenter, RequestTypeEnum, type TokenExchangeResponse, type UpdateCorrectionDataItem, type UpdatePurpose, type UpdateRequestDetails, type UserConsent, type UserConsentDetail, type UserConsentResponse, type UserDataRequest, type Workspace, checkAndRefreshAuth, compareEmails, createCaseRequest, createConsentClient, createOtpServer as createOtp, decodeJwtToken, ensureValidToken, exchangeTokenServer as exchangeToken, fetchActivities, fetchCaseHistory, fetchProducts, fetchUserConsents, formatActivityType, getActivityTypeStatus, getCookieValue, getFormData, getInitialState, injectPCStyles, isJwtExpired, isUserAuthenticated, manageConsent, setRefreshTokenCookie, signOutPrivacyCenter, useAuth, useBaseUrl, useCaseHistory, useInternalNavigation, verifyOtpServer as verifyOtp };
+export { type Activity, type ActivityBadgeStatus$1 as ActivityBadgeStatus, type ActivityDetail, type ActivityResponse, type ApiFetchOptions, type ApiResponse, type AuthContext, AuthProvider, type BaseRequest, BaseUrlProvider, type CaseHistoryDetail, type CaseHistoryResponse, type CaseRequest, type ConsentAction, type ConsentDataElement, type ConsentHistoryStatusSummary, ConsentStatusEnum, type CreateCaseResponse, type DataElement, type FetchOrgParams, type FormData, type FormDataResponse, type GrievanceOptions, type GrievanceTypeElement, GrievanceTypeEnum, type GrievanceValue, type InternalPage, type ManageConsentParams, type ManageConsentResponse, NavigationProvider, type NominatedPurposesGroup, type NominationData, type NominatorInfo, NotificationsPage, type OrganizationDetail, type OrganizationResponse, type OtpResponse, type OtpVerificationResponse, type Pagination, PrivacyCenterActivityPage, PrivacyCenterCaseDetailsPage, PrivacyCenterConsentManagerPage, PrivacyCenterFormPage, PrivacyCenterHomePage, PrivacyCenterLayout, type ProductConsentHistoryGroup, type Purpose, type RawPurposeWrapper, RedactoPrivacyCenter, RequestTypeEnum, type TokenExchangeResponse, type UpdateCorrectionDataItem, type UpdatePurpose, type UpdateRequestDetails, type UserConsent, type UserConsentDetail, type UserConsentResponse, type UserDataRequest, type Workspace, checkAndRefreshAuth, compareEmails, createCaseRequest, createConsentClient, createOtpServer as createOtp, decodeJwtToken, ensureValidToken, exchangeTokenServer as exchangeToken, fetchActivities, fetchCaseHistory, fetchProducts, fetchUserConsents, formatActivityType, getActivityTypeStatus, getCookieValue, getFormData, getInitialState, injectPCStyles, isJwtExpired, isUserAuthenticated, manageConsent, setRefreshTokenCookie, signOutPrivacyCenter, useAuth, useBaseUrl, useCaseHistory, useInternalNavigation, verifyOtpServer as verifyOtp };

package/dist/privacy-center.d.ts

@@ -102,6 +102,30 @@ declare function createConsentClient(baseUrl: string): {
      * Get document info/download URL for a case document (privacy center)
      */
     getCaseDocument(baseRequest: BaseRequest, caseUuid: string, documentUuid: string, authToken?: string): Promise<MessageDocument>;
+    /**
+     * List notifications (paginated, with filters)
+     */
+    getNotifications(baseRequest: BaseRequest, params?: NotificationQueryParams, authToken?: string): Promise<NotificationListResponse>;
+    /**
+     * Get notification summary (aggregated counts only)
+     */
+    getNotificationSummary(baseRequest: BaseRequest, authToken?: string): Promise<NotificationSummary>;
+    /**
+     * Get unread notification count (lightweight, for badge)
+     */
+    getUnreadCount(baseRequest: BaseRequest, authToken?: string): Promise<UnreadCountResponse>;
+    /**
+     * Mark a single notification as read
+     */
+    markNotificationRead(baseRequest: BaseRequest, notificationUuid: string, authToken?: string): Promise<NotificationActionResponse>;
+    /**
+     * Mark all notifications as read
+     */
+    markAllNotificationsRead(baseRequest: BaseRequest, authToken?: string): Promise<NotificationActionResponse>;
+    /**
+     * Acknowledge a notification (sets is_read and is_acknowledged to true)
+     */
+    acknowledgeNotification(baseRequest: BaseRequest, notificationUuid: string, authToken?: string): Promise<NotificationActionResponse>;
 };
 
 type Workspace = {
@@ -440,8 +464,61 @@ type UploadDocumentResponse = {
     allow_ai_processing: boolean;
     metadata: Record<string, string> | null;
 };
+type NotificationType = 'guardian_verification_request' | 'consent_expiry_warning' | 'new_consent_notice' | 'consent_withdrawal_confirmation' | 'data_request_status_update' | 'case_message' | 'grievance_status_update' | 'consent_regrant_prompt';
+type NotificationCategory = 'consent' | 'request' | 'system';
+type NotificationCTA = {
+    label: string;
+    style: 'primary' | 'secondary' | 'danger';
+    action_type: 'link' | 'acknowledge';
+    url?: string;
+};
+type Notification = {
+    uuid: string;
+    notification_type: NotificationType;
+    category: NotificationCategory;
+    title: string;
+    description: string;
+    is_read: boolean;
+    is_acknowledged: boolean;
+    source_type: string;
+    source_uuid: string | null;
+    request_type: string;
+    request_type_display?: string | null;
+    status_label: string;
+    status_label_display?: string | null;
+    ctas: NotificationCTA[];
+    created_at: string;
+};
+type NotificationSummary = {
+    total: number;
+    unread: number;
+    action_needed: number;
+    acknowledged: number;
+};
+type NotificationListResponse = {
+    data: Notification[];
+    total: number;
+    skip: number;
+    limit: number;
+    summary: NotificationSummary | null;
+};
+type UnreadCountResponse = {
+    count: number;
+};
+type NotificationActionResponse = {
+    message: string;
+};
+type NotificationQueryParams = {
+    category?: NotificationCategory;
+    notification_type?: NotificationType;
+    is_read?: boolean;
+    skip?: number;
+    limit?: number;
+    include_summary?: boolean;
+    language?: string;
+};
 
-type InternalPage = 'consent-manager' | 'form' | 'activity' | 'case-details';
+type InternalPage = 'consent-manager' | 'form' | 'activity' | 'case-details' | 'notifications';
 interface NavigationContextType {
     currentPage: InternalPage;
     navigateTo: (page: InternalPage) => void;
@@ -485,6 +562,8 @@ declare function PrivacyCenterActivityPage(): react_jsx_runtime.JSX.Element;
 
 declare const PrivacyCenterCaseDetailsPage: () => react_jsx_runtime.JSX.Element | null;
 
+declare const NotificationsPage: () => react_jsx_runtime.JSX.Element;
+
 type AuthContextValue = Readonly<{
     accessToken: string;
     refreshToken: string;
@@ -646,4 +725,4 @@ declare const useAuth: () => AuthContextValue;
  */
 declare const injectPCStyles: () => void;
 
-export { type Activity, type ActivityBadgeStatus$1 as ActivityBadgeStatus, type ActivityDetail, type ActivityResponse, type ApiFetchOptions, type ApiResponse, type AuthContext, AuthProvider, type BaseRequest, BaseUrlProvider, type CaseHistoryDetail, type CaseHistoryResponse, type CaseRequest, type ConsentAction, type ConsentDataElement, type ConsentHistoryStatusSummary, ConsentStatusEnum, type CreateCaseResponse, type DataElement, type FetchOrgParams, type FormData, type FormDataResponse, type GrievanceOptions, type GrievanceTypeElement, GrievanceTypeEnum, type GrievanceValue, type InternalPage, type ManageConsentParams, type ManageConsentResponse, NavigationProvider, type NominatedPurposesGroup, type NominationData, type NominatorInfo, type OrganizationDetail, type OrganizationResponse, type OtpResponse, type OtpVerificationResponse, type Pagination, PrivacyCenterActivityPage, PrivacyCenterCaseDetailsPage, PrivacyCenterConsentManagerPage, PrivacyCenterFormPage, PrivacyCenterHomePage, PrivacyCenterLayout, type ProductConsentHistoryGroup, type Purpose, type RawPurposeWrapper, RedactoPrivacyCenter, RequestTypeEnum, type TokenExchangeResponse, type UpdateCorrectionDataItem, type UpdatePurpose, type UpdateRequestDetails, type UserConsent, type UserConsentDetail, type UserConsentResponse, type UserDataRequest, type Workspace, checkAndRefreshAuth, compareEmails, createCaseRequest, createConsentClient, createOtpServer as createOtp, decodeJwtToken, ensureValidToken, exchangeTokenServer as exchangeToken, fetchActivities, fetchCaseHistory, fetchProducts, fetchUserConsents, formatActivityType, getActivityTypeStatus, getCookieValue, getFormData, getInitialState, injectPCStyles, isJwtExpired, isUserAuthenticated, manageConsent, setRefreshTokenCookie, signOutPrivacyCenter, useAuth, useBaseUrl, useCaseHistory, useInternalNavigation, verifyOtpServer as verifyOtp };
+export { type Activity, type ActivityBadgeStatus$1 as ActivityBadgeStatus, type ActivityDetail, type ActivityResponse, type ApiFetchOptions, type ApiResponse, type AuthContext, AuthProvider, type BaseRequest, BaseUrlProvider, type CaseHistoryDetail, type CaseHistoryResponse, type CaseRequest, type ConsentAction, type ConsentDataElement, type ConsentHistoryStatusSummary, ConsentStatusEnum, type CreateCaseResponse, type DataElement, type FetchOrgParams, type FormData, type FormDataResponse, type GrievanceOptions, type GrievanceTypeElement, GrievanceTypeEnum, type GrievanceValue, type InternalPage, type ManageConsentParams, type ManageConsentResponse, NavigationProvider, type NominatedPurposesGroup, type NominationData, type NominatorInfo, NotificationsPage, type OrganizationDetail, type OrganizationResponse, type OtpResponse, type OtpVerificationResponse, type Pagination, PrivacyCenterActivityPage, PrivacyCenterCaseDetailsPage, PrivacyCenterConsentManagerPage, PrivacyCenterFormPage, PrivacyCenterHomePage, PrivacyCenterLayout, type ProductConsentHistoryGroup, type Purpose, type RawPurposeWrapper, RedactoPrivacyCenter, RequestTypeEnum, type TokenExchangeResponse, type UpdateCorrectionDataItem, type UpdatePurpose, type UpdateRequestDetails, type UserConsent, type UserConsentDetail, type UserConsentResponse, type UserDataRequest, type Workspace, checkAndRefreshAuth, compareEmails, createCaseRequest, createConsentClient, createOtpServer as createOtp, decodeJwtToken, ensureValidToken, exchangeTokenServer as exchangeToken, fetchActivities, fetchCaseHistory, fetchProducts, fetchUserConsents, formatActivityType, getActivityTypeStatus, getCookieValue, getFormData, getInitialState, injectPCStyles, isJwtExpired, isUserAuthenticated, manageConsent, setRefreshTokenCookie, signOutPrivacyCenter, useAuth, useBaseUrl, useCaseHistory, useInternalNavigation, verifyOtpServer as verifyOtp };