@tantainnovative/ndpr-toolkit 1.0.3 → 1.0.5

package/.eslintrc.json

@@ -1,10 +0,0 @@
-{
-  "extends": "next/core-web-vitals",
-  "rules": {
-    "@typescript-eslint/no-unused-vars": "off",
-    "@typescript-eslint/no-empty-object-type": "off",
-    "react/no-unescaped-entities": "off",
-    "@typescript-eslint/no-explicit-any": "off"
-  },
-  "ignorePatterns": ["node_modules/**/*"]
-}

package/.github/workflows/ci.yml

@@ -1,36 +0,0 @@
-name: Continuous Integration
-
-on:
-  push:
-    branches: [ main, develop ]
-  pull_request:
-    branches: [ main, develop ]
-
-jobs:
-  lint-and-test:
-    runs-on: ubuntu-latest
-    
-    strategy:
-      matrix:
-        node-version: [20.x]
-    
-    steps:
-      - uses: actions/checkout@v4
-      
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      
-      - name: Install dependencies
-        run: npm ci
-      
-      - name: Lint
-        run: npm run lint
-      
-      - name: Type check
-        run: npx tsc --noEmit
-      
-      - name: Run tests
-        run: npm test

package/.github/workflows/nextjs.yml

@@ -1,104 +0,0 @@
-# Sample workflow for building and deploying a Next.js site to GitHub Pages
-#
-# To get started with Next.js see: https://nextjs.org/docs/getting-started
-#
-name: Deploy Next.js site to Pages
-
-on:
-  # Runs on pushes targeting the default branch
-  push:
-    branches: ["main"]
-
-  # Allows you to run this workflow manually from the Actions tab
-  workflow_dispatch:
-
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
-# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-jobs:
-  # Build job
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Detect package manager
-        id: detect-package-manager
-        run: |
-          if [ -f "${{ github.workspace }}/pnpm-lock.yaml" ]; then
-            echo "manager=pnpm" >> $GITHUB_OUTPUT
-            echo "command=install" >> $GITHUB_OUTPUT
-            echo "runner=pnpm" >> $GITHUB_OUTPUT
-            exit 0
-          elif [ -f "${{ github.workspace }}/yarn.lock" ]; then
-            echo "manager=yarn" >> $GITHUB_OUTPUT
-            echo "command=install" >> $GITHUB_OUTPUT
-            echo "runner=yarn" >> $GITHUB_OUTPUT
-            exit 0
-          elif [ -f "${{ github.workspace }}/package.json" ]; then
-            echo "manager=npm" >> $GITHUB_OUTPUT
-            echo "command=ci" >> $GITHUB_OUTPUT
-            echo "runner=npx --no-install" >> $GITHUB_OUTPUT
-            exit 0
-          else
-            echo "Unable to determine package manager"
-            exit 1
-          fi
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-          cache: ${{ steps.detect-package-manager.outputs.manager }}
-      - name: Setup pnpm
-        if: steps.detect-package-manager.outputs.manager == 'pnpm'
-        uses: pnpm/action-setup@v2
-        with:
-          version: 8
-          run_install: false
-      - name: Setup Pages
-        uses: actions/configure-pages@v5
-        with:
-          # Automatically inject basePath in your Next.js configuration file and disable
-          # server side image optimization (https://nextjs.org/docs/api-reference/next/image#unoptimized).
-          #
-          # You may remove this line if you want to manage the configuration yourself.
-          static_site_generator: next
-      - name: Restore cache
-        uses: actions/cache@v4
-        with:
-          path: |
-            .next/cache
-          # Generate a new cache whenever packages or source files change.
-          key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json', '**/yarn.lock') }}-${{ hashFiles('**.[jt]s', '**.[jt]sx') }}
-          # If source files changed but packages didn't, rebuild from a prior cache.
-          restore-keys: |
-            ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json', '**/yarn.lock') }}-
-      - name: Install dependencies
-        run: ${{ steps.detect-package-manager.outputs.manager }} ${{ steps.detect-package-manager.outputs.command }}
-      - name: Build with Next.js
-        run: ${{ steps.detect-package-manager.outputs.runner }} next build
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: ./out
-
-  # Deployment job
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

package/.husky/commit-msg

@@ -1,4 +0,0 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-npx --no -- commitlint --edit ${1}

package/.husky/pre-commit

@@ -1,4 +0,0 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-npx lint-staged

package/.lintstagedrc.js

@@ -1,4 +0,0 @@
-module.exports = {
-  '*.{js,jsx,ts,tsx}': ['eslint --fix', 'prettier --write'],
-  '*.{json,md}': ['prettier --write'],
-};

package/.nvmrc

@@ -1 +0,0 @@
-20

package/.versionrc

@@ -1,17 +0,0 @@
-{
-  "types": [
-    {"type": "feat", "section": "Features"},
-    {"type": "fix", "section": "Bug Fixes"},
-    {"type": "chore", "hidden": true},
-    {"type": "docs", "section": "Documentation"},
-    {"type": "style", "hidden": true},
-    {"type": "refactor", "section": "Code Refactoring"},
-    {"type": "perf", "section": "Performance Improvements"},
-    {"type": "test", "hidden": true},
-    {"type": "build", "hidden": true},
-    {"type": "ci", "hidden": true}
-  ],
-  "commitUrlFormat": "https://github.com/tantainnovative/ndpr-toolkit/commit/{{hash}}",
-  "compareUrlFormat": "https://github.com/tantainnovative/ndpr-toolkit/compare/{{previousTag}}...{{currentTag}}",
-  "releaseCommitMessageFormat": "chore(release): {{currentTag}}"
-}

package/CLAUDE.md

@@ -1,90 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-The Nigerian Data Protection Compliance Toolkit (NDPR-Toolkit) is a Next.js application that helps developers implement NDPR and DPA compliant features. It's deployed as a static site to GitHub Pages.
-
-## Development Commands
-
-### Package Manager
-Always use `pnpm` for all package management operations.
-
-### Core Commands
-- **Development server**: `pnpm dev` (uses Turbopack)
-- **Build**: `pnpm build`
-- **Production server**: `pnpm start`
-- **Static export**: `pnpm export` or `pnpm build:static`
-- **Deploy to GitHub Pages**: `pnpm deploy`
-
-### Testing
-- **Run tests**: `pnpm test`
-- **Run specific test**: `pnpm test -- path/to/test.spec.ts`
-- **Tests use**: Jest with React Testing Library and jest-environment-jsdom
-
-### Code Quality
-- **Lint**: `pnpm lint`
-- **Git hooks**: Pre-commit runs lint-staged, commit-msg runs commitlint
-- **Commit format**: Use conventional commits (feat, fix, docs, style, refactor, test, chore)
-
-### Release Management
-- **Standard release**: `pnpm release`
-- **Version bumps**: `pnpm release:patch`, `pnpm release:minor`, `pnpm release:major`
-
-## Architecture
-
-### Tech Stack
-- **Next.js 15.3.1** with App Router
-- **React 19** with TypeScript
-- **Tailwind CSS v4** with custom theme configuration
-- **Radix UI** for accessible components
-- **Nextra** for documentation pages
-
-### Project Structure
-```
-src/
-├── app/                    # Next.js pages (App Router)
-│   ├── docs/              # Documentation pages
-│   ├── ndpr-demos/        # Interactive NDPR compliance demos
-│   └── page.tsx           # Homepage
-├── components/            # Feature-based component organization
-│   ├── breach-notification/
-│   ├── consent/
-│   ├── data-subject-rights/
-│   ├── dpia/
-│   ├── privacy-policy/
-│   └── ui/               # Base UI components
-├── hooks/                 # Custom React hooks
-├── lib/                   # Services and utilities
-│   ├── consentService.ts
-│   ├── requestService.ts  # LocalStorage-based state management
-│   └── utils.ts
-└── types/                 # TypeScript type definitions
-```
-
-### Key Patterns
-
-1. **State Management**: Demo data persists in localStorage via service layer (e.g., `requestService.ts`)
-2. **Component Architecture**: Feature-based organization with modular, reusable components
-3. **Static Site**: Configured for GitHub Pages with basePath and assetPrefix in `next.config.ts`
-4. **Type Safety**: Comprehensive TypeScript types in `types/` directory
-5. **Styling**: Tailwind CSS with CSS variables for theming
-
-### NDPR Compliance Features
-
-When working on NDPR features, understand these core modules:
-
-1. **Consent Management** (`components/consent/`): Multi-purpose consent with granular controls
-2. **Data Subject Rights** (`components/data-subject-rights/`): Request portal for access, deletion, etc.
-3. **Privacy Policy Generator** (`components/privacy-policy/`): Step-by-step wizard
-4. **DPIA Tool** (`components/dpia/`): Data Protection Impact Assessment questionnaire
-5. **Breach Notification** (`components/breach-notification/`): Incident reporting system
-
-### Important Notes
-
-- All data in demos uses localStorage - no backend required
-- Components are designed for NDPR/DPA compliance out of the box
-- The project auto-deploys to GitHub Pages on main branch pushes
-- TypeScript strict mode is enabled - maintain type safety
-- Follow existing component patterns when adding new features

package/commitlint.config.js

@@ -1,36 +0,0 @@
-module.exports = {
-  extends: ['@commitlint/config-conventional'],
-  rules: {
-    'body-leading-blank': [1, 'always'],
-    'body-max-line-length': [2, 'always', 100],
-    'footer-leading-blank': [1, 'always'],
-    'footer-max-line-length': [2, 'always', 100],
-    'header-max-length': [2, 'always', 100],
-    'subject-case': [
-      2,
-      'never',
-      ['sentence-case', 'start-case', 'pascal-case', 'upper-case'],
-    ],
-    'subject-empty': [2, 'never'],
-    'subject-full-stop': [2, 'never', '.'],
-    'type-case': [2, 'always', 'lower-case'],
-    'type-empty': [2, 'never'],
-    'type-enum': [
-      2,
-      'always',
-      [
-        'build',
-        'chore',
-        'ci',
-        'docs',
-        'feat',
-        'fix',
-        'perf',
-        'refactor',
-        'revert',
-        'style',
-        'test',
-      ],
-    ],
-  },
-};

package/jest.config.js

@@ -1,31 +0,0 @@
-const nextJest = require('next/jest');
-
-const createJestConfig = nextJest({
-  // Provide the path to your Next.js app to load next.config.js and .env files in your test environment
-  dir: './',
-});
-
-// Add any custom config to be passed to Jest
-const customJestConfig = {
-  setupFilesAfterEnv: ['<rootDir>/jest.setup.js'],
-  testEnvironment: 'jest-environment-jsdom',
-  moduleNameMapper: {
-    // Handle module aliases (if you have them in tsconfig.json)
-    '^@/(.*)$': '<rootDir>/src/$1',
-  },
-  testPathIgnorePatterns: [
-    '<rootDir>/node_modules/',
-    '<rootDir>/.next/',
-    '<rootDir>/out/'
-  ],
-  collectCoverage: true,
-  collectCoverageFrom: [
-    'src/**/*.{js,jsx,ts,tsx}',
-    '!src/**/*.d.ts',
-    '!src/**/_*.{js,jsx,ts,tsx}',
-    '!src/**/index.{js,jsx,ts,tsx}',
-  ],
-};
-
-// createJestConfig is exported this way to ensure that next/jest can load the Next.js config which is async
-module.exports = createJestConfig(customJestConfig);

package/jest.setup.js

@@ -1,15 +0,0 @@
-// Learn more: https://github.com/testing-library/jest-dom
-import '@testing-library/jest-dom';
-
-// Mock localStorage for tests
-if (typeof window !== 'undefined') {
-  Object.defineProperty(window, 'localStorage', {
-    value: {
-      getItem: jest.fn(),
-      setItem: jest.fn(),
-      removeItem: jest.fn(),
-      clear: jest.fn(),
-    },
-    writable: true
-  });
-}

package/packages/ndpr-toolkit/jest.config.js

@@ -1,23 +0,0 @@
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'jsdom',
-  moduleNameMapper: {
-    '\\.(css|less|scss|sass)$': 'identity-obj-proxy',
-  },
-  setupFilesAfterEnv: ['<rootDir>/src/setupTests.ts'],
-  testPathIgnorePatterns: ['/node_modules/', '/dist/'],
-  collectCoverageFrom: [
-    'src/**/*.{ts,tsx}',
-    '!src/**/*.d.ts',
-    '!src/index.ts',
-    '!src/setupTests.ts',
-  ],
-  coverageThreshold: {
-    global: {
-      branches: 70,
-      functions: 70,
-      lines: 70,
-      statements: 70,
-    },
-  },
-};

package/packages/ndpr-toolkit/src/__tests__/components/consent/ConsentBanner.test.tsx

@@ -1,119 +0,0 @@
-import React from 'react';
-import { render, screen, fireEvent } from '@testing-library/react';
-import { ConsentBanner } from '../../../components/consent/ConsentBanner';
-import { ConsentOption } from '../../../types/consent';
-
-describe('ConsentBanner', () => {
-  const mockOnSave = jest.fn();
-  
-  const consentOptions: ConsentOption[] = [
-    {
-      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
-    },
-    {
-      id: 'marketing',
-      label: 'Marketing Cookies',
-      description: 'Cookies used for marketing purposes.',
-      required: false
-    }
-  ];
-
-  const renderComponent = (props = {}) => {
-    return render(
-      <ConsentBanner
-        options={consentOptions}
-        position="bottom"
-        onSave={mockOnSave}
-        show={true}
-        storageKey="test-consent"
-        {...props}
-      />
-    );
-  };
-
-  beforeEach(() => {
-    mockOnSave.mockClear();
-  });
-
-  it('renders the consent banner correctly', () => {
-    renderComponent();
-    
-    expect(screen.getByText(/We Value Your Privacy/i)).toBeInTheDocument();
-    expect(screen.getByRole('button', { name: /accept all/i })).toBeInTheDocument();
-    expect(screen.getByRole('button', { name: /reject all/i })).toBeInTheDocument();
-    expect(screen.getByRole('button', { name: /customize/i })).toBeInTheDocument();
-  });
-
-  it('calls onSave when "Accept All" is clicked', () => {
-    renderComponent();
-    
-    fireEvent.click(screen.getByRole('button', { name: /accept all/i }));
-    
-    expect(mockOnSave).toHaveBeenCalled();
-    const saveCall = mockOnSave.mock.calls[0][0];
-    expect(saveCall.consents.necessary).toBe(true);
-    expect(saveCall.consents.analytics).toBe(true);
-    expect(saveCall.consents.marketing).toBe(true);
-    expect(saveCall.timestamp).toBeDefined();
-    expect(saveCall.version).toBe('1.0');
-  });
-
-  it('shows preferences panel when "Customize" is clicked', () => {
-    renderComponent();
-    
-    fireEvent.click(screen.getByRole('button', { name: /customize/i }));
-    
-    expect(screen.getByText(/necessary cookies/i)).toBeInTheDocument();
-    expect(screen.getByText(/analytics cookies/i)).toBeInTheDocument();
-    expect(screen.getByText(/marketing cookies/i)).toBeInTheDocument();
-    expect(screen.getByRole('button', { name: /save preferences/i })).toBeInTheDocument();
-  });
-
-  it('disables required consent options', () => {
-    renderComponent();
-    
-    fireEvent.click(screen.getByRole('button', { name: /customize/i }));
-    
-    // The checkbox for necessary cookies should be disabled
-    const necessaryCheckbox = screen.getByLabelText(/necessary cookies/i);
-    expect(necessaryCheckbox).toBeDisabled();
-  });
-
-  it('allows toggling non-required consent options', () => {
-    renderComponent();
-    
-    fireEvent.click(screen.getByRole('button', { name: /customize/i }));
-    
-    // The checkbox for analytics cookies should be enabled
-    const analyticsCheckbox = screen.getByLabelText(/analytics cookies/i);
-    
-    // Toggle the checkbox
-    fireEvent.click(analyticsCheckbox);
-    
-    // Save preferences
-    fireEvent.click(screen.getByRole('button', { name: /save preferences/i }));
-    
-    expect(mockOnSave).toHaveBeenCalled();
-    const saveCall = mockOnSave.mock.calls[0][0];
-    expect(saveCall.consents.necessary).toBeDefined();
-    expect(saveCall.consents.analytics).toBeDefined();
-    expect(saveCall.method).toBe('customize');
-  });
-
-  it('renders with the correct position', () => {
-    renderComponent({ position: 'top' });
-    
-    const banner = screen.getByRole('dialog');
-    expect(banner).toHaveClass('top-0');
-    expect(banner).not.toHaveClass('bottom-0');
-  });
-});

package/packages/ndpr-toolkit/src/__tests__/components/consent/ConsentManager.test.tsx

@@ -1,122 +0,0 @@
-import React from 'react';
-import { render, screen, fireEvent } from '@testing-library/react';
-import { ConsentManager } from '../../../components/consent/ConsentManager';
-import { ConsentOption, ConsentSettings } from '../../../types/consent';
-
-describe('ConsentManager', () => {
-  const mockOnSave = jest.fn();
-  
-  const consentOptions: ConsentOption[] = [
-    {
-      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
-    }
-  ];
-  
-  beforeEach(() => {
-    mockOnSave.mockClear();
-  });
-
-  it('renders the consent manager correctly', () => {
-    render(
-      <ConsentManager
-        options={consentOptions}
-        onSave={mockOnSave}
-      />
-    );
-    
-    // Check that the title and description are rendered
-    expect(screen.getByText(/Manage Your Privacy Settings/i)).toBeInTheDocument();
-    expect(screen.getByText(/Update your consent preferences/i)).toBeInTheDocument();
-    
-    // Check that the consent options are rendered
-    expect(screen.getByText(/Necessary Cookies/i)).toBeInTheDocument();
-    expect(screen.getByText(/Analytics Cookies/i)).toBeInTheDocument();
-    
-    // Check that the buttons are rendered
-    expect(screen.getByRole('button', { name: /Save Preferences/i })).toBeInTheDocument();
-    expect(screen.getByRole('button', { name: /Reset to Defaults/i })).toBeInTheDocument();
-  });
-
-  it('calls onSave when Save Preferences is clicked', () => {
-    render(
-      <ConsentManager
-        options={consentOptions}
-        onSave={mockOnSave}
-      />
-    );
-    
-    // Click the save button
-    fireEvent.click(screen.getByRole('button', { name: /Save Preferences/i }));
-    
-    // Check that onSave was called with the correct settings
-    expect(mockOnSave).toHaveBeenCalled();
-    const saveCall = mockOnSave.mock.calls[0][0];
-    expect(saveCall.consents).toBeDefined();
-    expect(saveCall.timestamp).toBeDefined();
-    expect(saveCall.version).toBe('1.0');
-    expect(saveCall.method).toBe('manager');
-  });
-
-  it('handles empty options array', () => {
-    render(
-      <ConsentManager
-        options={[]}
-        onSave={mockOnSave}
-      />
-    );
-    
-    // Should still render the manager even with empty options
-    expect(screen.getByText(/Manage Your Privacy Settings/i)).toBeInTheDocument();
-  });
-
-  it('allows toggling non-required consent options', () => {
-    render(
-      <ConsentManager
-        options={consentOptions}
-        onSave={mockOnSave}
-      />
-    );
-    
-    // Find the analytics checkbox (non-required)
-    const analyticsCheckboxes = screen.getAllByRole('checkbox');
-    const analyticsCheckbox = analyticsCheckboxes.find(checkbox => !checkbox.hasAttribute('disabled'));
-    
-    // Toggle the checkbox
-    if (analyticsCheckbox) {
-      fireEvent.click(analyticsCheckbox);
-      
-      // Save preferences
-      fireEvent.click(screen.getByRole('button', { name: /Save Preferences/i }));
-      
-      // Check that onSave was called
-      expect(mockOnSave).toHaveBeenCalled();
-    }
-  });
-  
-  it('disables required consent options', () => {
-    render(
-      <ConsentManager
-        options={consentOptions}
-        onSave={mockOnSave}
-      />
-    );
-    
-    // Find all checkboxes
-    const checkboxes = screen.getAllByRole('checkbox');
-    
-    // Find the necessary checkbox (required)
-    const necessaryCheckbox = checkboxes.find(checkbox => checkbox.hasAttribute('disabled'));
-    
-    // Check thatit&apos;s disabled
-    expect(necessaryCheckbox).toBeDisabled();
-  });
-});