@redacto.io/privacy-center-sdk 1.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,23 @@
+
+
+> @redacto.io/privacy-center-sdk@1.1.0 build /Users/abhishekashyap/Documents/consent-sdk/packages/privacy-center-sdk
+> tsup
+
+CLI Building entry: {"index":"src/index.ts"}
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/abhishekashyap/Documents/consent-sdk/packages/privacy-center-sdk/tsup.config.ts
+CLI Target: es2019
+CLI Cleaning output folder
+ESM Build start
+CJS Build start
+ESM dist/index.css 205.00 B
+ESM dist/index.mjs 891.90 KB
+ESM ⚡️ Build success in 39ms
+CJS dist/index.css 205.00 B
+CJS dist/index.js  912.72 KB
+CJS ⚡️ Build success in 39ms
+DTS Build start
+DTS ⚡️ Build success in 1114ms
+DTS dist/index.d.mts 618.00 B
+DTS dist/index.d.ts  618.00 B

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @redacto.io/privacy-center-sdk
+
+## 1.1.0
+
+### Minor Changes
+
+- initial release

package/README.md

@@ -0,0 +1,273 @@
+# @redacto.io/privacy-center-sdk
+
+A standalone Privacy Center SDK for Redacto that provides a comprehensive React component library for building privacy centers with consent management, data request forms, and activity tracking.
+
+## Overview
+
+The Redacto Privacy Center SDK enables developers to easily integrate a complete privacy center into their React applications. It provides users with a self-service portal to manage their consents, submit data subject access requests (DSAR), and track their privacy-related activities while maintaining compliance with privacy regulations like GDPR, CCPA, and others.
+
+## Features
+
+- **Consent Manager**: View, search, filter, and revoke user consents with a comprehensive table interface
+- **Data Request Forms**: Submit DSAR requests including:
+  - Access requests
+  - Data correction requests
+  - Data erasure requests
+  - Grievance/complaint submissions
+- **Activity History**: Track privacy center activities and events with detailed timestamps
+- **Case Management**: View and manage data request cases with status tracking
+- **Multi-language Support**: 20+ languages including Indian regional languages with automatic language detection
+- **Theme Support**: Light and dark mode with customizable themes
+- **Authentication**: JWT-based authentication with automatic token refresh
+- **Responsive Design**: Mobile-first responsive design that works across all devices
+
+## Installation
+
+```bash
+# Using npm
+npm install @redacto.io/privacy-center-sdk
+
+# Using pnpm
+pnpm add @redacto.io/privacy-center-sdk
+
+# Using yarn
+yarn add @redacto.io/privacy-center-sdk
+```
+
+### Peer Dependencies
+
+This package requires React to be installed in your project:
+
+```bash
+npm install react
+```
+
+See the [Peer Dependencies](#peer-dependencies) section for specific version requirements.
+
+## Quick Start
+
+```tsx
+import { RedactoPrivacyCenter } from '@redacto.io/privacy-center-sdk';
+
+function App() {
+  const handleError = (error: Error): boolean => {
+    console.error('Privacy Center Error:', error);
+    // Return true to allow default error handling (signout/redirect)
+    // Return false to prevent default handling and let parent handle it
+    return true;
+  };
+
+  return (
+    <RedactoPrivacyCenter
+      baseUrl="https://api.redacto.io"
+      slug="your-organization-slug"
+      theme="light"
+      accessToken="your-access-token"
+      refreshToken="your-refresh-token"
+      onError={handleError}
+    />
+  );
+}
+```
+
+## API Reference
+
+### `RedactoPrivacyCenter`
+
+The main component that renders the complete privacy center interface.
+
+#### Props
+
+| Prop | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `baseUrl` | `string` | Yes | - | Consent server base URL (e.g., `https://api.redacto.io`) |
+| `slug` | `string` | Yes | - | Organization slug identifier |
+| `theme` | `'light' \| 'dark'` | No | `'light'` | Theme mode for the privacy center |
+| `accessToken` | `string` | Yes | - | JWT access token for API authentication |
+| `refreshToken` | `string` | Yes | - | JWT refresh token for token renewal |
+| `onError` | `(error: Error) => boolean` | Yes | - | Error handler callback. Return `true` to allow default error handling, `false` to handle errors manually |
+| `initialPage` | `'consent-manager' \| 'form' \| 'activity'` | No | `'consent-manager'` | Initial page to display when the component mounts |
+| `onBack` | `'back' \| 'signout'` | No | - | Behavior for the back button. `'back'` navigates to previous page, `'signout'` signs out the user |
+
+#### Example
+
+```tsx
+<RedactoPrivacyCenter
+  baseUrl={process.env.REACT_APP_CONSENT_SERVER_URL}
+  slug="acme-corp"
+  theme="dark"
+  accessToken={accessToken}
+  refreshToken={refreshToken}
+  onError={(error) => {
+    console.error(error);
+    // Handle error (e.g., redirect to login)
+    return true;
+  }}
+  initialPage="consent-manager"
+  onBack="signout"
+/>
+```
+
+## Exports
+
+The SDK exports the following components and types:
+
+### Components
+
+- **`RedactoPrivacyCenter`** - Main component that renders the complete privacy center
+- **`PrivacyCenterLayout`** - Layout wrapper component with sidebar navigation
+- **`PrivacyCenterHomePage`** - Home page component that handles internal routing
+- **`PrivacyCenterConsentManagerPage`** - Consent manager page component
+- **`PrivacyCenterFormPage`** - Data request form page component
+- **`PrivacyCenterActivityPage`** - Activity history page component
+
+### Types
+
+- **`InternalPage`** - Type for internal page navigation: `'consent-manager' | 'form' | 'activity'`
+
+### Usage Example with Individual Components
+
+```tsx
+import {
+  PrivacyCenterLayout,
+  PrivacyCenterConsentManagerPage,
+  PrivacyCenterFormPage,
+  PrivacyCenterActivityPage,
+} from '@redacto.io/privacy-center-sdk';
+
+// Use individual components for custom layouts
+function CustomPrivacyCenter() {
+  return (
+    <PrivacyCenterLayout slug="acme-corp" theme="light">
+      <PrivacyCenterConsentManagerPage />
+    </PrivacyCenterLayout>
+  );
+}
+```
+
+## Supported Languages
+
+The SDK supports 20+ languages with automatic language detection:
+
+- **English** (en)
+- **Hindi** (hi)
+- **Assamese** (as)
+- **Bhojpuri** (bho)
+- **Dogri** (doi)
+- **Konkani** (gom)
+- **Gujarati** (gu)
+- **Kannada** (kn)
+- **Maithili** (mai)
+- **Malayalam** (ml)
+- **Manipuri** (mni-Mtei)
+- **Marathi** (mr)
+- **Nepali** (ne)
+- **Odia** (or)
+- **Punjabi** (pa)
+- **Sanskrit** (sa)
+- **Sindhi** (sd)
+- **Tamil** (ta)
+- **Telugu** (te)
+- **Urdu** (ur)
+
+The SDK automatically detects the user's browser language and uses the appropriate translation. Language preferences are stored in localStorage and persist across sessions.
+
+## Architecture
+
+The SDK is built with a modular architecture using React Context API for state management:
+
+### Context Providers
+
+- **`AuthProvider`**: Manages authentication tokens (access and refresh tokens)
+- **`BaseUrlProvider`**: Provides API base URLs for consent server and user server
+- **`NavigationProvider`**: Handles internal navigation between pages
+- **`OrganizationContext`**: Manages organization and workspace data
+- **`LocaleContext`**: Handles language and locale settings
+
+### Component Hierarchy
+
+```
+RedactoPrivacyCenter
+├── BaseUrlProvider
+│   └── AuthProvider
+│       └── NavigationProvider
+│           └── PrivacyCenterLayout
+│               └── PrivacyCenterHomePage
+│                   ├── PrivacyCenterConsentManagerPage
+│                   ├── PrivacyCenterFormPage
+│                   └── PrivacyCenterActivityPage
+```
+
+### API Client
+
+The SDK includes a built-in API client (`createConsentClient`) that handles:
+- JWT token authentication with Bearer tokens
+- Automatic error handling and retries
+- Token refresh on expiration
+- Request/response transformation
+
+## Peer Dependencies
+
+The following peer dependency is required:
+
+| Package | Version | Description |
+|---------|---------|-------------|
+| `react` | `^16.8.0 \|\| ^17 \|\| ^18 \|\| ^19` | React library |
+
+### Included Dependencies
+
+The SDK includes the following dependencies (bundled with the package):
+
+- `@tanstack/react-query`: Data fetching and caching
+- `@tanstack/react-table`: Table component library
+- `i18next`: Internationalization framework
+- `react-i18next`: React bindings for i18next
+- `rizzui`: UI component library
+- `react-toastify`: Toast notification library
+- `react-icons`: Icon library
+- `clsx`: Utility for constructing className strings
+- `simplebar-react`: Custom scrollbar component
+- `nprogress`: Progress bar library
+- `dayjs`: Date manipulation library
+- `lodash`: Utility functions
+- `tailwind-merge`: Tailwind CSS class merging utility
+
+## Development
+
+### Building the Package
+
+```bash
+# Build the package
+pnpm run build
+
+# Build in watch mode
+pnpm run dev
+```
+
+### Project Structure
+
+```
+privacy-center-sdk/
+├── src/
+│   ├── api/              # API client and utilities
+│   ├── components/        # React components
+│   ├── context/           # React context providers
+│   ├── lib/               # Utility functions and types
+│   ├── locales/           # Translation files
+│   ├── ui/                # UI components
+│   └── utils/             # Helper utilities
+├── locales/               # Language translation files
+└── package.json
+```
+
+### TypeScript Support
+
+The package includes full TypeScript support with type definitions. All components and utilities are fully typed.
+
+## License
+
+Apache-2.0
+
+## Support
+
+For issues, questions, or contributions, please refer to the main project repository.

package/dist/index.css

@@ -0,0 +1,8 @@
+@import "rizzui/styles.css";
+@import "react-toastify/dist/ReactToastify.css";
+@import "simplebar-react/dist/simplebar.min.css";
+
+/* src/styles.css */
+.rizzui-select-options {
+  z-index: 9999 !important;
+}

package/dist/index.d.mts

@@ -0,0 +1,17 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type InternalPage = 'consent-manager' | 'form' | 'activity';
+
+interface RedactoPrivacyCenterProps {
+    baseUrl: string;
+    slug: string;
+    theme?: 'light' | 'dark';
+    accessToken: string;
+    refreshToken: string;
+    onError: (error: Error) => boolean;
+    initialPage?: InternalPage;
+    onBack?: 'back' | 'signout';
+}
+declare function RedactoPrivacyCenter({ baseUrl, slug, theme, accessToken, refreshToken, onError, initialPage, onBack, }: RedactoPrivacyCenterProps): react_jsx_runtime.JSX.Element;
+
+export { type InternalPage, RedactoPrivacyCenter };

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type InternalPage = 'consent-manager' | 'form' | 'activity';
+
+interface RedactoPrivacyCenterProps {
+    baseUrl: string;
+    slug: string;
+    theme?: 'light' | 'dark';
+    accessToken: string;
+    refreshToken: string;
+    onError: (error: Error) => boolean;
+    initialPage?: InternalPage;
+    onBack?: 'back' | 'signout';
+}
+declare function RedactoPrivacyCenter({ baseUrl, slug, theme, accessToken, refreshToken, onError, initialPage, onBack, }: RedactoPrivacyCenterProps): react_jsx_runtime.JSX.Element;
+
+export { type InternalPage, RedactoPrivacyCenter };