@redacto.io/consent-sdk-react 10.0.0-beta.0 → 10.0.0-beta.2

package/dist/privacy-center.d.ts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { ReactNode } from 'react';
 import * as _tanstack_react_query from '@tanstack/react-query';
 
@@ -33,9 +33,12 @@ type BaseRequest = {
  * Creates a client instance with a specific base URL.
  * @param baseUrl - Consent server base URL (Python service, e.g. http://host/consent)
  * @param ledgerBaseUrl - Go ledger base URL (e.g. http://host:8090/consent-ledger).
- *   Used for user-consents reads which are served from the ledger's `/public/...` paths.
+ *   Used for user-consents reads/writes served from the ledger's `/public/...` paths.
+ *   When omitted, those calls fall back to the legacy Python
+ *   `/dsar/privacy-center` endpoints and payloads (pre-ledger behavior), so
+ *   integrations without a deployed ledger keep working.
  */
-declare function createConsentClient(baseUrl: string, ledgerBaseUrl: string): {
+declare function createConsentClient(baseUrl: string, ledgerBaseUrl?: string): {
     /**
      * Get form data (privacy center)
      */
@@ -96,14 +99,17 @@ declare function createConsentClient(baseUrl: string, ledgerBaseUrl: string): {
     /**
      * Manage consent (privacy center) - revoke, regrant, or renew.
      *
-     * The Go ledger has no manage-consent route, so this is expressed as a
-     * `partial` submit-consent on the ledger — mirroring the Python dual-write
-     * relay (`build_consent_management_payload`): the affected purpose is
-     * re-submitted with `selected: false` to revoke or `selected: true` to
-     * regrant/renew, and `partial: true` so the rest of the notice's purposes
-     * are left untouched. The principal is resolved from the JWT, so no
-     * `contact`/identifiers are sent in the body, and `consent_event_uuid` is
-     * omitted so the ledger mints a fresh event.
+     * The Go ledger has no manage-consent route, so with a ledger configured
+     * this is expressed as a `partial` submit-consent on the ledger — mirroring
+     * the Python dual-write relay (`build_consent_management_payload`): the
+     * affected purpose is re-submitted with `selected: false` to revoke or
+     * `selected: true` to regrant/renew, and `partial: true` so the rest of the
+     * notice's purposes are left untouched. The principal is resolved from the
+     * JWT, so no `contact`/identifiers are sent in the body, and
+     * `consent_event_uuid` is omitted so the ledger mints a fresh event.
+     *
+     * Without a ledger, the legacy Python `/manage-consent?status=` endpoint is
+     * used with its `{ purpose_uuid, contact, ... }` payload.
      */
     manageConsent(baseRequest: BaseRequest, purposeId: string, contact: string, status: "revoke" | "regrant" | "renew", authToken?: string, options?: Omit<ApiFetchOptions, "getAuthToken">, nominatorContact?: string, dataElementUuids?: string[], productUuid?: string, noticeUuid?: string, dataElements?: Array<{
         uuid: string;
@@ -113,6 +119,18 @@ declare function createConsentClient(baseUrl: string, ledgerBaseUrl: string): {
      * Get activities (privacy center)
      */
     getActivities(baseRequest: BaseRequest, offset?: number, limit?: number, language?: string, authToken?: string, options?: Omit<ApiFetchOptions, "getAuthToken">): Promise<unknown>;
+    /**
+     * List all data principals that share this session's contact
+     * (shared-contact profile picker). Identity is derived server-side from the
+     * JWT — the caller sends nothing but its bearer token.
+     */
+    listIdentities(baseRequest: BaseRequest, authToken?: string, options?: Omit<ApiFetchOptions, "getAuthToken">): Promise<IdentityListResponse>;
+    /**
+     * Re-scope the session to a chosen principal uuid (must be one of the
+     * principals sharing this session's contact). Returns fresh access/refresh
+     * tokens scoped to that principal.
+     */
+    selectPrincipal(baseRequest: BaseRequest, principalUuid: string, authToken?: string, options?: Omit<ApiFetchOptions, "getAuthToken">): Promise<SelectPrincipalResponse>;
     /**
      * Get receipts (privacy center) — consent receipts for the authenticated user
      */
@@ -372,6 +390,8 @@ type PurposeItem = {
     method: string;
     data_elements: ConsentDataElement[];
     link_reason: string | null;
+    revocable?: boolean;
+    revoke_warning_message?: string | null;
     notice_uuid: string | null;
 };
 type ConsentGroup = {
@@ -607,6 +627,21 @@ type NotificationQueryParams = {
     include_summary?: boolean;
     language?: string;
 };
+type IdentityCandidate = Readonly<{
+    uuid: string;
+    org_user_id?: string | null;
+    primary_email?: string | null;
+    primary_mobile?: string | null;
+    created_at?: string | null;
+}>;
+type IdentityListResponse = Readonly<{
+    identities: IdentityCandidate[];
+}>;
+type SelectPrincipalResponse = Readonly<{
+    token: string;
+    refresh_token: string;
+    expires_at?: string;
+}>;
 
 type InternalPage = 'consent-manager' | 'form' | 'activity' | 'case-details' | 'notifications' | 'receipts';
 interface NavigationContextType {
@@ -619,12 +654,12 @@ interface NavigationContextType {
 declare const NavigationProvider: ({ children, initialPage }: {
     children: ReactNode;
     initialPage?: InternalPage;
-}) => react_jsx_runtime.JSX.Element;
+}) => react.JSX.Element;
 declare const useInternalNavigation: () => NavigationContextType;
 
 interface RedactoPrivacyCenterProps {
     baseUrl: string;
-    ledgerBaseUrl: string;
+    ledgerBaseUrl?: string;
     slug: string;
     accessToken: string;
     refreshToken: string;
@@ -632,26 +667,26 @@ interface RedactoPrivacyCenterProps {
     initialPage?: InternalPage;
     onBack?: 'back' | 'signout';
 }
-declare function RedactoPrivacyCenter({ baseUrl, ledgerBaseUrl, slug, accessToken, refreshToken, onError, initialPage, onBack, }: RedactoPrivacyCenterProps): react_jsx_runtime.JSX.Element;
+declare function RedactoPrivacyCenter({ baseUrl, ledgerBaseUrl, slug, accessToken, refreshToken, onError, initialPage, onBack, }: RedactoPrivacyCenterProps): react.JSX.Element;
 
 interface PrivacyCenterLayoutProps {
     children: ReactNode;
     slug: string;
     onBack?: 'back' | 'signout';
 }
-declare function PrivacyCenterLayout({ children, slug, onBack }: PrivacyCenterLayoutProps): react_jsx_runtime.JSX.Element;
+declare function PrivacyCenterLayout({ children, slug, onBack }: PrivacyCenterLayoutProps): react.JSX.Element;
 
-declare function PrivacyCenterHomePage(): react_jsx_runtime.JSX.Element;
+declare function PrivacyCenterHomePage(): react.JSX.Element;
 
-declare function PrivacyCenterConsentManagerPage(): react_jsx_runtime.JSX.Element;
+declare function PrivacyCenterConsentManagerPage(): react.JSX.Element;
 
-declare function PrivacyCenterFormPage(): react_jsx_runtime.JSX.Element;
+declare function PrivacyCenterFormPage(): react.JSX.Element;
 
-declare function PrivacyCenterActivityPage(): react_jsx_runtime.JSX.Element;
+declare function PrivacyCenterActivityPage(): react.JSX.Element;
 
-declare const PrivacyCenterCaseDetailsPage: () => react_jsx_runtime.JSX.Element | null;
+declare const PrivacyCenterCaseDetailsPage: () => react.JSX.Element | null;
 
-declare const NotificationsPage: () => react_jsx_runtime.JSX.Element;
+declare const NotificationsPage: () => react.JSX.Element;
 
 type AuthContextValue = Readonly<{
     accessToken: string;
@@ -662,18 +697,18 @@ type AuthContextValue = Readonly<{
 }>;
 type BaseUrlContextValue = Readonly<{
     baseUrl: string;
-    ledgerBaseUrl: string;
+    ledgerBaseUrl?: string;
     consentClient: ReturnType<typeof createConsentClient>;
 }>;
 
 declare const BaseUrlProvider: ({ children, baseUrl, ledgerBaseUrl, }: {
     children: ReactNode;
     baseUrl: string;
-    ledgerBaseUrl: string;
-}) => react_jsx_runtime.JSX.Element;
+    ledgerBaseUrl?: string;
+}) => react.JSX.Element;
 declare const useBaseUrl: () => Readonly<{
     baseUrl: string;
-    ledgerBaseUrl: string;
+    ledgerBaseUrl?: string;
     consentClient: ReturnType<typeof createConsentClient>;
 }>;
 
@@ -840,7 +875,7 @@ declare const manageConsent: ({ organizationId, workspaceId, purposeId, contact,
 declare const fetchActivities: (organizationId: string, workspaceId: string, offset?: number, limit?: number, authContext?: AuthContext, consentClient?: BaseUrlContextValue["consentClient"], language?: string) => Promise<ActivityDetail | null>;
 declare const fetchCaseHistory: (organizationId: string, workspaceId: string, contact: string, offset?: number, limit?: number, authContext?: AuthContext, consentClient?: BaseUrlContextValue["consentClient"], language?: string) => Promise<CaseHistoryDetail | null>;
 
-declare const useCaseHistory: (organizationId: string | undefined, workspaceId: string | undefined, contact: string | undefined, authContext?: AuthContext) => _tanstack_react_query.UseQueryResult<CaseRequest[], Error>;
+declare const useCaseHistory: (organizationId: string | undefined, workspaceId: string | undefined, contact: string | undefined, authContext?: AuthContext) => _tanstack_react_query.UseQueryResult<NoInfer<CaseRequest[]>, Error>;
 
 interface AuthProviderProps {
     children: ReactNode;
@@ -848,7 +883,7 @@ interface AuthProviderProps {
     refreshToken: string;
     onError: (error: Error) => boolean;
 }
-declare const AuthProvider: ({ children, accessToken: initialAccessToken, refreshToken: initialRefreshToken, onError, }: AuthProviderProps) => react_jsx_runtime.JSX.Element;
+declare const AuthProvider: ({ children, accessToken: initialAccessToken, refreshToken: initialRefreshToken, onError, }: AuthProviderProps) => react.JSX.Element;
 declare const useAuth: () => AuthContextValue;
 
 /**