@tantainnovative/ndpr-toolkit 1.0.2 → 1.0.4

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+## 1.0.0 (2025-05-02)
+
+
+### Features
+
+* initial implementation of NDPR-Toolkit with all key components ([b41aeef](https://github.com/tantainnovative/ndpr-toolkit/commit/b41aeefe3184ce69ed09f3d8c0fdacb860a98427))
+
+
+### Bug Fixes
+
+* resolve ESLint errors for successful build ([3f78939](https://github.com/tantainnovative/ndpr-toolkit/commit/3f7893902cc7ec67913a7e19f6a804d01e69896e))
+* resolve type errors for successful build ([b827186](https://github.com/tantainnovative/ndpr-toolkit/commit/b8271865a77b097f0ce839ad13555b4bfe12fe2e))

package/CNAME

@@ -0,0 +1 @@
+ndprtoolkit.com.ng

package/CONTRIBUTING.md

@@ -0,0 +1,87 @@
+# Contributing to NDPR-Toolkit
+
+Thank you for considering contributing to the Nigerian Data Protection Compliance Toolkit! This document outlines the process for contributing to this project.
+
+## Code of Conduct
+
+By participating in this project, you agree to abide by our Code of Conduct. Please be respectful and considerate of others.
+
+## How to Contribute
+
+### Reporting Bugs
+
+If you find a bug, please create an issue in the GitHub repository with the following information:
+
+1. A clear, descriptive title
+2. Steps to reproduce the bug
+3. Expected behavior
+4. Actual behavior
+5. Screenshots (if applicable)
+6. Environment information (browser, OS, etc.)
+
+### Suggesting Features
+
+We welcome feature suggestions! Please create an issue with:
+
+1. A clear, descriptive title
+2. Detailed description of the proposed feature
+3. Any relevant examples or mockups
+4. Explanation of why this feature would be useful to the project
+
+### Pull Requests
+
+We follow a standard GitHub workflow:
+
+1. Fork the repository
+2. Create a new branch for your feature or bug fix
+3. Make your changes
+4. Write or update tests as needed
+5. Ensure all tests pass
+6. Commit your changes using conventional commit messages
+7. Push to your fork
+8. Submit a pull request
+
+### Commit Message Convention
+
+We use conventional commits to automate versioning and changelog generation. Please format your commit messages as follows:
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+Types include:
+- `feat`: A new feature
+- `fix`: A bug fix
+- `docs`: Documentation changes
+- `style`: Code style changes (formatting, etc.)
+- `refactor`: Code changes that neither fix bugs nor add features
+- `perf`: Performance improvements
+- `test`: Adding or updating tests
+- `chore`: Changes to the build process or auxiliary tools
+
+Example:
+```
+feat(consent): add ability to customize consent banner colors
+```
+
+## Development Setup
+
+1. Clone your fork of the repository
+2. Install dependencies: `npm install`
+3. Start the development server: `npm run dev`
+4. Make your changes
+5. Run tests: `npm test`
+
+## Release Process
+
+Releases are managed by the maintainers using semantic versioning. The process is automated through GitHub Actions.
+
+## Questions?
+
+If you have any questions about contributing, please open an issue with your question.
+
+Thank you for contributing to the NDPR-Toolkit!

package/README.md

@@ -1,467 +1,104 @@
-# NDPR Toolkit
-
-<div align="center">
-
-![NDPR Toolkit Logo](https://via.placeholder.com/200x200?text=NDPR+Toolkit)
-
-A comprehensive enterprise solution for implementing NDPR-compliant features in web applications, aligned with the Nigerian Data Protection Regulation (NDPR) and Data Protection Act (DPA).
-
-[![npm version](https://img.shields.io/npm/v/@tantainnovative/ndpr-toolkit.svg)](https://www.npmjs.com/package/@tantainnovative/ndpr-toolkit)
-[![license](https://img.shields.io/npm/l/@tantainnovative/ndpr-toolkit.svg)](https://github.com/tantainnovative/ndpr-toolkit/blob/main/LICENSE)
-[![TypeScript](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/)
-[![React](https://img.shields.io/badge/React-18.0%2B-blue)](https://reactjs.org/)
-
-</div>
-
-## Overview
-
-The NDPR Toolkit is an enterprise-grade solution that provides a comprehensive set of React components, hooks, and utilities to help organizations implement NDPR-compliant features in their web applications with minimal development effort. Designed by compliance experts and developers, this toolkit offers a complete solution for privacy policy management, consent handling, data subject rights, breach notification, and data protection impact assessments.
-
-> **NDPR Toolkit is actively maintained and regularly updated to ensure compliance with the latest Nigerian data protection regulations.**
-
-## Key Features
-
-### Privacy Policy Management
-
-- **PolicyGenerator**: Create customizable, NDPR-compliant privacy policies with an intuitive form interface
-- **PolicyPreview**: Display generated policies with professional formatting and section navigation
-- **PolicyExporter**: Export policies in multiple formats (PDF, HTML, Markdown) with compliance notices
-
-### Consent Management
-
-- **ConsentBanner**: Implement cookie consent banners with customizable appearance and behavior
-- **ConsentManager**: Track and manage user consent preferences across your application
-- **ConsentStorage**: Securely store and retrieve consent records with built-in persistence
-
-### Data Subject Rights (DSR)
-
-- **DSRRequestForm**: Collect and validate data subject requests with comprehensive form validation
-- **DSRTracker**: Monitor the status and progress of data subject requests
-- **DSRDashboard**: Visualize and manage all data subject requests in one place
-
-### Data Protection Impact Assessment (DPIA)
-
-- **DPIAQuestionnaire**: Guide users through the DPIA process with step-by-step questionnaires
-- **DPIAReport**: Generate comprehensive DPIA reports based on questionnaire responses
-- **StepIndicator**: Track progress through multi-step DPIA processes
-
-### Breach Notification
-
-- **BreachReportForm**: Collect essential information about data breaches
-- **BreachRiskAssessment**: Evaluate the risk level of reported breaches
-- **RegulatoryReportGenerator**: Create NDPR-compliant breach notification reports
-- **BreachNotificationManager**: Manage the entire breach notification workflow
-
-### Enterprise Features
-
-- **Advanced Conditional Logic**: Support for complex conditional blocks in policy templates
-- **Professional Formatting**: Enterprise-ready formatting for all exported documents
-- **Comprehensive Type System**: Full TypeScript support with detailed interfaces and type definitions
-- **Modular Architecture**: Use only the components you need with tree-shakable imports
-- **Accessibility**: WCAG 2.1 AA compliant components for inclusive user experiences
-
-## Installation
-
-```bash
-# Using npm
-npm install @tantainnovative/ndpr-toolkit
-
-# Using yarn
-yarn add @tantainnovative/ndpr-toolkit
-
-# Using pnpm
-pnpm add @tantainnovative/ndpr-toolkit
-```
-
-### React 19 Compatibility
-
-If you&apos;re using React 19 and encounter peer dependency warnings with other packages in your project, you can use the `--legacy-peer-deps` flag:
+# Nigerian Data Protection Compliance Toolkit (NDPR-Toolkit)
+
+An open-source toolkit that helps Nigerian developers implement Nigeria Data Protection Regulation (NDPR) and Data Protection Act (DPA) compliant features in their web applications.
+
+## Project Vision
+
+This toolkit simplifies regulatory compliance for startups and businesses operating in Nigeria by providing ready-to-use components and tools for implementing data protection requirements.
+
+## Key Components
+
+### 1. Consent Management System
+- User-friendly consent banners and modals with customizable styling
+- Granular consent options (necessary, functional, analytics, marketing)
+- Consent storage and retrieval mechanisms
+- Consent change history tracking
+- Time-stamped audit trails
+
+### 2. Data Subject Rights Portal
+- Pre-built UI components for handling:
+  - Right to access personal data
+  - Right to rectification
+  - Right to erasure ("right to be forgotten")
+  - Right to restrict processing
+  - Right to data portability
+  - Dashboard for data controllers to manage requests
+  - Local storage requestService to track and update requests in demos
+
+### 3. Privacy Policy Generator
+- Interactive wizard to create NDPR-compliant privacy policies
+- Template system with customizable sections
+- Auto-update notifications when regulatory requirements change
+- Version history tracking
+
+### 4. Data Protection Impact Assessment (DPIA) Tool
+- Questionnaire-based tool to help organizations assess data processing risks
+- Risk scoring matrix
+- Mitigation recommendation engine
+- Exportable reports for compliance documentation
+
+### 5. Breach Notification Module
+- Templates for mandatory breach notifications
+- Workflow for documenting breach details
+- Timeline tracking to ensure 72-hour notification compliance
+- Notification delivery to authorities via API (if available)
+### 6. Data Subject Request Service
+- Lightweight requestService storing requests in browser localStorage for demos
+- Helper methods to update request status and retrieve history
+
+## Getting Started
+
+First, run the development server:
 
 ```bash
-npm install @tantainnovative/ndpr-toolkit --legacy-peer-deps
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
 ```
 
-Alternatively, you can create a `.npmrc` file in your project root with the following content:
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
 
-```
-legacy-peer-deps=true
-```
+## Deployment
 
-This will make npm ignore peer dependency conflicts during installation.
+### GitHub Pages
 
-## Quick Start
+This project is configured to deploy automatically to GitHub Pages using GitHub Actions. When you push changes to the `main` branch, the following will happen:
 
-### Consent Management
+1. The GitHub Actions workflow will build the project
+2. The built files will be deployed to GitHub Pages
+3. Your site will be available at `https://[your-username].github.io/ndpr-toolkit/`
 
-```jsx
-import { ConsentBanner, ConsentManager, ConsentStorage, useConsent } from '@tantainnovative/ndpr-toolkit';
+To manually deploy to GitHub Pages:
 
-function MyApp() {
-  return (
-    <ConsentManager
-      options={[
-        {
-          id: 'necessary',
-          label: 'Necessary Cookies',
-          description: 'Essential cookies for the website to function.',
-          required: true
-        },
-        {
-          id: 'analytics',
-          label: 'Analytics Cookies',
-          description: 'Cookies that help us understand how you use our website.',
-          required: false
-        }
-      ]}
-      storageKey="my-app-consent"
-      autoLoad={true}
-      autoSave={true}
-    >
-      <AppContent />
-      <ConsentBanner 
-        position="bottom"
-        privacyPolicyUrl="/privacy-policy"
-        showPreferences={true}
-        onSave={(consents) => console.log('Consent saved:', consents)}
-      />
-    </ConsentManager>
-  );
-}
-
-function AppContent() {
-  // Use the useConsent hook to manage consent state
-  const { consents, hasConsented, updateConsent } = useConsent();
-  
-  // Check if user has given consent for analytics
-  if (hasConsented('analytics')) {
-    // Initialize analytics
-  }
-  
-  return (
-    <div>
-      {/* Your app content */}
-    </div>
-  );
-}
-```
-
-### Privacy Policy Generator
-
-```jsx
-import { PolicyGenerator, PolicyPreview, PolicyExporter, usePrivacyPolicy } from '@tantainnovative/ndpr-toolkit';
-
-function PrivacyPolicyPage() {
-  const { policy, updateVariableValue, generatePolicy } = usePrivacyPolicy();
-  const [generatedPolicy, setGeneratedPolicy] = useState(null);
-  
-  // Define your variables
-  const variables = {
-    organizationName: 'Acme Corporation',
-    websiteUrl: 'https://acme.com',
-    contactEmail: 'privacy@acme.com',
-    lastUpdated: new Date().toLocaleDateString()
-  };
-  
-  return (
-    <div>
-      {!generatedPolicy ? (
-        <PolicyGenerator 
-          templates={[
-            {
-              id: 'standard',
-              name: 'Standard Privacy Policy',
-              description: 'A comprehensive privacy policy suitable for most websites and applications.',
-              sections: [
-                {
-                  id: 'introduction',
-                  title: 'Introduction',
-                  template: 'This Privacy Policy explains how {{organizationName}} collects, uses, and protects your personal data when you visit {{websiteUrl}}.',
-                  required: true,
-                  included: true
-                },
-                // More sections...
-              ]
-            }
-          ]}
-          variables={variables}
-          onComplete={(data) => {
-            // Generate policy with variables
-            const result = generatePolicyText(data.sections, variables);
-            setGeneratedPolicy({
-              title: `Privacy Policy for ${variables.organizationName}`,
-              content: result.fullText,
-              lastUpdated: new Date()
-            });
-          }}
-        />
-      ) : (
-        <>
-          <PolicyPreview 
-            policy={generatedPolicy}
-            variables={variables}
-            onVariableChange={(newVariables) => {
-              // Update variables and regenerate policy
-            }}
-          />
-          
-          <PolicyExporter
-            policy={generatedPolicy}
-            formats={['html', 'pdf', 'markdown']}
-            filename="privacy-policy"
-          />
-        </>
-      )}
-    </div>
-  );
-}
-```
-
-## Component Categories
-
-### Consent Management
-- `ConsentBanner`: Cookie consent banner with customizable options
-- `ConsentManager`: Component for managing consent preferences
-- `ConsentStorage`: Storage mechanism for consent settings with support for localStorage, sessionStorage, and cookies
-- `useConsent`: Hook for managing consent state
-
-### Data Subject Rights
-- `DSRRequestForm`: Form for submitting data subject rights requests
-- `DSRDashboard`: Admin dashboard for managing DSR requests
-- `DSRTracker`: Component for tracking the status of DSR requests
-- `useDSR`: Hook for managing DSR state
-- Types: `DSRType`, `DSRStatus`, `DSRRequest` for type-safe implementation
-
-### DPIA (Data Protection Impact Assessment)
-- `DPIAQuestionnaire`: Interactive questionnaire for conducting DPIAs
-- `DPIAReport`: Component for generating DPIA reports
-- `StepIndicator`: Progress indicator for multi-step processes
-- `useDPIA`: Hook for managing DPIA state
-- Types: `DPIAQuestion`, `DPIASection`, `DPIARisk`, `DPIAResult` for structured assessments
-
-### Breach Notification
-- `BreachReportForm`: Form for reporting data breaches
-- `BreachRiskAssessment`: Tool for assessing breach risk and severity
-- `BreachNotificationManager`: Component for managing breach notifications
-- `RegulatoryReportGenerator`: Tool for generating regulatory reports for NITDA
-- `useBreach`: Hook for managing breach notification state
-- Types: `BreachReport`, `RiskAssessment`, `NotificationRequirement` for compliance with 72-hour notification requirements
-
-### Privacy Policy
-- `PolicyGenerator`: Component for generating privacy policies
-- `PolicyPreview`: Preview component for privacy policies
-- `PolicyExporter`: Tool for exporting privacy policies to different formats
-- `generatePolicyText`: Utility for creating dynamic policies with variable support
-- `usePrivacyPolicy`: Hook for managing privacy policy state
-
-## Implementation Guides
-
-### Setting Up Consent Management
-
-```jsx
-// 1. Wrap your application with ConsentManager
-import { ConsentManager } from 'ndpr-toolkit';
-
-function App() {
-  return (
-    <ConsentManager
-      options={[
-        { id: 'necessary', label: 'Necessary', description: '...', required: true },
-        { id: 'analytics', label: 'Analytics', description: '...', required: false },
-        { id: 'marketing', label: 'Marketing', description: '...', required: false }
-      ]}
-      storageKey="my-app-consent"
-      autoLoad={true}
-      autoSave={true}
-    >
-      <YourApp />
-    </ConsentManager>
-  );
-}
-
-// 2. Add the ConsentBanner to your layout
-import { ConsentBanner } from 'ndpr-toolkit';
-
-function Layout({ children }) {
-  return (
-    <>
-      {children}
-      <ConsentBanner
-        position="bottom"
-        privacyPolicyUrl="/privacy-policy"
-        showPreferences={true}
-      />
-    </>
-  );
-}
-
-// 3. Use the consent values in your components
-import { useConsent } from 'ndpr-toolkit';
-
-function AnalyticsComponent() {
-  const { hasConsented } = useConsent();
-  
-  useEffect(() => {
-    if (hasConsented('analytics')) {
-      // Initialize analytics
-    }
-  }, [hasConsented]);
-  
-  return null;
-}
-```
-
-### Implementing a Data Subject Rights Portal
-
-```jsx
-import { DSRRequestForm, DSRTracker, DSRDashboard, useDSR } from '@tantainnovative/ndpr-toolkit';
-
-// 1. Create a form for data subjects to submit requests
-function DSRPortal() {
-  const { submitRequest } = useDSR();
-  
-  const handleSubmit = (formData) => {
-    const request = submitRequest({
-      type: formData.type,
-      subject: {
-        name: formData.name,
-        email: formData.email,
-        phone: formData.phone
-      },
-      details: formData.details
-    });
-    
-    // Show confirmation with tracking ID
-    alert(`Your request has been submitted. Your tracking ID is: ${request.id}`);
-  };
-  
-  return (
-    <DSRRequestForm
-      onSubmit={handleSubmit}
-      requestTypes={[
-        { id: 'access', label: 'Access my data' },
-        { id: 'rectification', label: 'Correct my data' },
-        { id: 'erasure', label: 'Delete my data' },
-        { id: 'restriction', label: 'Restrict processing of my data' },
-        { id: 'portability', label: 'Data portability' },
-        { id: 'objection', label: 'Object to processing' }
-      ]}
-    />
-  );
-}
-
-// 2. Create an admin dashboard for managing requests
-import { DSRDashboard } from '@tantainnovative/ndpr-toolkit';
-
-function AdminDashboard() {
-  const { requests, updateRequest, deleteRequest } = useDSR();
-  
-  return (
-    <DSRDashboard
-      requests={requests}
-      onUpdateRequest={updateRequest}
-      onDeleteRequest={deleteRequest}
-    />
-  );
-}
-```
-
-### Setting Up a Breach Notification System
-
-```jsx
-import { BreachReportForm, BreachRiskAssessment, RegulatoryReportGenerator, useBreach } from '@tantainnovative/ndpr-toolkit';
-
-// 1. Create a form for reporting breaches
-function BreachReporting() {
-  const { submitBreachReport } = useBreach();
-  
-  const handleSubmit = (formData) => {
-    const report = submitBreachReport({
-      title: formData.title,
-      description: formData.description,
-      category: formData.category,
-      discoveredAt: Date.now(),
-      reporter: {
-        name: formData.reporterName,
-        email: formData.reporterEmail,
-        department: formData.department
-      },
-      affectedSystems: formData.systems,
-      dataTypes: formData.dataTypes,
-      status: 'ongoing'
-    });
-    
-    // Redirect to risk assessment
-    navigate(`/breach/${report.id}/assess`);
-  };
-  
-  return (
-    <BreachReportForm
-      onSubmit={handleSubmit}
-      categories={[
-        { id: 'unauthorized-access', label: 'Unauthorized Access' },
-        { id: 'data-loss', label: 'Data Loss' },
-        { id: 'system-compromise', label: 'System Compromise' }
-      ]}
-    />
-  );
-}
+```bash
+# Build the project
+npm run build
 
-// 2. Create a risk assessment component
-function RiskAssessment({ breachId }) {
-  const { performRiskAssessment, determineNotificationRequirements } = useBreach();
-  
-  const handleAssessment = (assessmentData) => {
-    const assessment = performRiskAssessment({
-      breachId,
-      assessor: {
-        name: 'Jane Smith',
-        role: 'Data Protection Officer',
-        email: 'jane@example.com'
-      },
-      ...assessmentData
-    });
-    
-    const requirements = determineNotificationRequirements({
-      breachId,
-      riskAssessmentId: assessment.id
-    });
-    
-    // Show notification requirements
-    if (requirements.nitdaNotificationRequired) {
-      // Deadline is 72 hours from discovery
-      const deadline = new Date(requirements.nitdaNotificationDeadline);
-      alert(`NITDA notification required by ${deadline.toLocaleString()}`);
-    }
-  };
-  
-  return (
-    <BreachRiskAssessment
-      breachId={breachId}
-      onComplete={handleAssessment}
-    />
-  );
-}
+# Deploy to GitHub Pages (if you have gh-pages installed)
+npm run deploy
 ```
 
-## Documentation
-
-For detailed documentation, visit [https://ndpr-toolkit.tantainnovative.com/docs](https://ndpr-toolkit.tantainnovative.com/docs)
+#### Configuration
 
-### API Reference
+The GitHub Pages deployment is configured in the following files:
+- `next.config.ts` - Contains the Next.js configuration for static export
+- `.github/workflows/deploy.yml` - Contains the GitHub Actions workflow for automated deployment
 
-Detailed API documentation is available for all components:
+## Technical Stack
 
-- [Consent Management](https://ndpr-toolkit.tantainnovative.com/docs/components/consent-management)
-- [Data Subject Rights](https://ndpr-toolkit.tantainnovative.com/docs/components/data-subject-rights)
-- [DPIA Questionnaire](https://ndpr-toolkit.tantainnovative.com/docs/components/dpia-questionnaire)
-- [Breach Notification](https://ndpr-toolkit.tantainnovative.com/docs/components/breach-notification)
-- [Privacy Policy Generator](https://ndpr-toolkit.tantainnovative.com/docs/components/privacy-policy-generator)
-- [React Hooks](https://ndpr-toolkit.tantainnovative.com/docs/components/hooks)
+- Next.js with App Router
+- TypeScript
+- Tailwind CSS
+- React
 
-## Contributing
+## License
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+MIT License
 
-## License
+## Developed by
 
-MIT © Tanta Innovative
+Tanta Innovative - Positioning as a thought leader in regulatory tech solutions for Nigeria