@tantainnovative/ndpr-toolkit 2.1.2 → 2.4.0

package/dist/dsr-BTT-Xd7H.d.mts

@@ -0,0 +1,307 @@
+import React from 'react';
+import { c as RequestType, D as DSRRequest, a as DSRStatus } from './dsr-Cm9lzWG7.mjs';
+import './useDSR-YYZ6FYFs.mjs';
+import './dsr-D_eTNc4S.mjs';
+
+/**
+ * Represents the data submitted by the DSR request form.
+ */
+interface DSRFormSubmission {
+    /** The selected request type identifier */
+    requestType: string;
+    /** Data subject personal information */
+    dataSubject: {
+        fullName: string;
+        email: string;
+        phone?: string;
+        identifierType: string;
+        identifierValue: string;
+    };
+    /** Additional information provided for the selected request type */
+    additionalInfo?: Record<string, any>;
+    /** Timestamp (ms) when the form was submitted */
+    submittedAt: number;
+}
+interface DSRRequestFormClassNames {
+    root?: string;
+    title?: string;
+    description?: string;
+    form?: string;
+    fieldGroup?: string;
+    label?: string;
+    input?: string;
+    select?: string;
+    textarea?: string;
+    submitButton?: string;
+    /** Alias for submitButton */
+    primaryButton?: string;
+    successMessage?: string;
+    /** Custom class applied when isSubmitting is true (e.g. a loading overlay) */
+    loadingOverlay?: string;
+}
+interface DSRRequestFormProps {
+    /**
+     * Array of request types that can be submitted
+     */
+    requestTypes: RequestType[];
+    /**
+     * Callback function called when form is submitted
+     */
+    onSubmit: (data: DSRFormSubmission) => void;
+    /**
+     * Callback function called when form validation fails
+     */
+    onValidationError?: (errors: Record<string, string>) => void;
+    /**
+     * Title displayed on the form
+     * @default "Submit a Data Subject Request"
+     */
+    title?: string;
+    /**
+     * Description text displayed on the form
+     * @default "Use this form to exercise your rights under the Nigeria Data Protection Act (NDPA), Part IV, Sections 29-36."
+     */
+    description?: string;
+    /**
+     * Text for the submit button
+     * @default "Submit Request"
+     */
+    submitButtonText?: string;
+    /**
+     * Custom CSS class for the form
+     */
+    className?: string;
+    /**
+     * Custom CSS class for the submit button
+     */
+    buttonClassName?: string;
+    /**
+     * Whether to show a confirmation message after submission
+     * @default true
+     */
+    showConfirmation?: boolean;
+    /**
+     * Confirmation message to display after submission
+     * @default "Your request has been submitted successfully. You will receive a confirmation email shortly."
+     */
+    confirmationMessage?: string;
+    /**
+     * Whether to require identity verification
+     * @default true
+     */
+    requireIdentityVerification?: boolean;
+    /**
+     * Types of identifiers accepted for verification
+     * @default ["email", "account", "customer_id"]
+     */
+    identifierTypes?: Array<{
+        id: string;
+        label: string;
+    }>;
+    /**
+     * Whether to collect additional contact information
+     * @default true
+     */
+    collectAdditionalContact?: boolean;
+    /**
+     * Custom labels for form fields
+     */
+    labels?: {
+        name?: string;
+        email?: string;
+        requestType?: string;
+        description?: string;
+        submit?: string;
+    };
+    /**
+     * Object of CSS class overrides keyed by semantic section name.
+     */
+    classNames?: DSRRequestFormClassNames;
+    /**
+     * When true, all default Tailwind classes are removed so consumers
+     * can style from scratch using classNames.
+     */
+    unstyled?: boolean;
+    /**
+     * Whether the form is currently submitting.
+     * When true, the submit button is disabled and shows "Submitting..." text.
+     */
+    isSubmitting?: boolean;
+    /**
+     * Default values to pre-fill form fields.
+     * Useful for editing existing requests or pre-populating known data.
+     */
+    defaultValues?: Partial<DSRFormSubmission>;
+    /**
+     * Callback fired when the form is reset via the Reset button.
+     * To fully remount the component (clearing all internal state),
+     * change the `key` prop from the parent.
+     */
+    onReset?: () => void;
+}
+/**
+ * Data Subject Request form component. Implements NDPA Part IV, Sections 29-36
+ * covering data subject rights including access, rectification, erasure, and portability.
+ */
+declare const DSRRequestForm: React.FC<DSRRequestFormProps>;
+
+interface DSRDashboardClassNames {
+    root?: string;
+    header?: string;
+    title?: string;
+    filters?: string;
+    requestList?: string;
+    requestItem?: string;
+    statusBadge?: string;
+    detailPanel?: string;
+}
+interface DSRDashboardProps {
+    /**
+     * List of DSR requests to display
+     */
+    requests: DSRRequest[];
+    /**
+     * Callback function called when a request is selected
+     */
+    onSelectRequest?: (requestId: string) => void;
+    /**
+     * Callback function called when a request status is updated
+     */
+    onUpdateStatus?: (requestId: string, status: DSRStatus) => void;
+    /**
+     * Callback function called when a request is assigned
+     */
+    onAssignRequest?: (requestId: string, assignee: string) => void;
+    /**
+     * Title displayed on the dashboard
+     * @default "Data Subject Request Dashboard"
+     */
+    title?: string;
+    /**
+     * Description text displayed on the dashboard
+     * @default "Track and manage data subject requests in compliance with NDPA Part IV requirements."
+     */
+    description?: string;
+    /**
+     * Custom CSS class for the dashboard
+     */
+    className?: string;
+    /**
+     * Custom CSS class for the buttons
+     */
+    buttonClassName?: string;
+    /**
+     * Whether to show the request details
+     * @default true
+     */
+    showRequestDetails?: boolean;
+    /**
+     * Whether to show the request timeline
+     * @default true
+     */
+    showRequestTimeline?: boolean;
+    /**
+     * Whether to show the deadline alerts
+     * @default true
+     */
+    showDeadlineAlerts?: boolean;
+    /**
+     * List of possible assignees
+     */
+    assignees?: string[];
+    /**
+     * Object of CSS class overrides keyed by semantic section name.
+     */
+    classNames?: DSRDashboardClassNames;
+    /**
+     * When true, all default Tailwind classes are removed so consumers
+     * can style from scratch using classNames.
+     */
+    unstyled?: boolean;
+}
+/**
+ * Data Subject Request dashboard component. Supports compliance with NDPA Part IV,
+ * providing tools to track, manage, and respond to data subject requests within required timeframes.
+ */
+declare const DSRDashboard: React.FC<DSRDashboardProps>;
+
+interface DSRTrackerClassNames {
+    root?: string;
+    header?: string;
+    title?: string;
+    stats?: string;
+    statCard?: string;
+    table?: string;
+    tableHeader?: string;
+    tableRow?: string;
+    statusBadge?: string;
+}
+interface DSRTrackerProps {
+    /**
+     * List of DSR requests to track
+     */
+    requests: DSRRequest[];
+    /**
+     * Callback function called when a request is selected
+     */
+    onSelectRequest?: (requestId: string) => void;
+    /**
+     * Title displayed on the tracker
+     * @default "DSR Request Tracker"
+     */
+    title?: string;
+    /**
+     * Description text displayed on the tracker
+     * @default "Track the status and progress of data subject requests as required by NDPA Part IV."
+     */
+    description?: string;
+    /**
+     * Custom CSS class for the tracker
+     */
+    className?: string;
+    /**
+     * Custom CSS class for the buttons
+     */
+    buttonClassName?: string;
+    /**
+     * Whether to show the summary statistics
+     * @default true
+     */
+    showSummaryStats?: boolean;
+    /**
+     * Whether to show the request type breakdown
+     * @default true
+     */
+    showTypeBreakdown?: boolean;
+    /**
+     * Whether to show the status breakdown
+     * @default true
+     */
+    showStatusBreakdown?: boolean;
+    /**
+     * Whether to show the timeline chart
+     * @default true
+     */
+    showTimelineChart?: boolean;
+    /**
+     * Whether to show the overdue requests
+     * @default true
+     */
+    showOverdueRequests?: boolean;
+    /**
+     * Object of CSS class overrides keyed by semantic section name.
+     */
+    classNames?: DSRTrackerClassNames;
+    /**
+     * When true, all default Tailwind classes are removed so consumers
+     * can style from scratch using classNames.
+     */
+    unstyled?: boolean;
+}
+/**
+ * DSR tracking and analytics component. Supports compliance with NDPA Part IV,
+ * providing summary statistics, deadline tracking, and compliance metrics for data subject requests.
+ */
+declare const DSRTracker: React.FC<DSRTrackerProps>;
+
+export { DSRDashboard as D, type DSRDashboardClassNames as a, type DSRFormSubmission as b, DSRRequestForm as c, type DSRRequestFormClassNames as d, DSRTracker as e, type DSRTrackerClassNames as f };

package/dist/{dsr-pQzQ3H1O.d.mts → dsr-Cm9lzWG7.d.mts}

@@ -125,4 +125,4 @@ interface DSRRequest {
     extensionReason?: string;
 }
 
-export type { DSRRequest as D, RequestType as R, DSRStatus as a, DSRType as b, RequestStatus as c };
+export type { DSRRequest as D, RequestStatus as R, DSRStatus as a, DSRType as b, RequestType as c };

package/dist/{dsr-pQzQ3H1O.d.ts → dsr-Cm9lzWG7.d.ts}

@@ -125,4 +125,4 @@ interface DSRRequest {
     extensionReason?: string;
 }
 
-export type { DSRRequest as D, RequestType as R, DSRStatus as a, DSRType as b, RequestStatus as c };
+export type { DSRRequest as D, RequestStatus as R, DSRStatus as a, DSRType as b, RequestType as c };

package/dist/{dsr-whPkiI0_.d.mts → dsr-D_eTNc4S.d.mts}

@@ -1,4 +1,4 @@
-import { D as DSRRequest } from './dsr-pQzQ3H1O.mjs';
+import { D as DSRRequest } from './dsr-Cm9lzWG7.mjs';
 
 /**
  * Formats a DSR request for display or submission

package/dist/{dsr-jq5NUEdz.d.ts → dsr-pNtVb1BK.d.ts}

@@ -1,4 +1,4 @@
-import { D as DSRRequest } from './dsr-pQzQ3H1O.js';
+import { D as DSRRequest } from './dsr-Cm9lzWG7.js';
 
 /**
  * Formats a DSR request for display or submission

package/dist/dsr.d.mts

@@ -1,192 +1,5 @@
-import React from 'react';
-import { R as RequestType, D as DSRRequest, a as DSRStatus } from './dsr-pQzQ3H1O.mjs';
-export { b as DSRType, c as RequestStatus } from './dsr-pQzQ3H1O.mjs';
-export { u as useDSR } from './useDSR-OXM5Q9rf.mjs';
-export { f as formatDSRRequest } from './dsr-whPkiI0_.mjs';
-
-interface DSRRequestFormProps {
-    /**
-     * Array of request types that can be submitted
-     */
-    requestTypes: RequestType[];
-    /**
-     * Callback function called when form is submitted
-     */
-    onSubmit: (formData: any) => void;
-    /**
-     * Title displayed on the form
-     * @default "Submit a Data Subject Request"
-     */
-    title?: string;
-    /**
-     * Description text displayed on the form
-     * @default "Use this form to exercise your rights under the Nigeria Data Protection Act (NDPA)."
-     */
-    description?: string;
-    /**
-     * Text for the submit button
-     * @default "Submit Request"
-     */
-    submitButtonText?: string;
-    /**
-     * Custom CSS class for the form
-     */
-    className?: string;
-    /**
-     * Custom CSS class for the submit button
-     */
-    buttonClassName?: string;
-    /**
-     * Whether to show a confirmation message after submission
-     * @default true
-     */
-    showConfirmation?: boolean;
-    /**
-     * Confirmation message to display after submission
-     * @default "Your request has been submitted successfully. You will receive a confirmation email shortly."
-     */
-    confirmationMessage?: string;
-    /**
-     * Whether to require identity verification
-     * @default true
-     */
-    requireIdentityVerification?: boolean;
-    /**
-     * Types of identifiers accepted for verification
-     * @default ["email", "account", "customer_id"]
-     */
-    identifierTypes?: Array<{
-        id: string;
-        label: string;
-    }>;
-    /**
-     * Whether to collect additional contact information
-     * @default true
-     */
-    collectAdditionalContact?: boolean;
-    /**
-     * Custom labels for form fields
-     */
-    labels?: {
-        name?: string;
-        email?: string;
-        requestType?: string;
-        description?: string;
-        submit?: string;
-    };
-}
-declare const DSRRequestForm: React.FC<DSRRequestFormProps>;
-
-interface DSRDashboardProps {
-    /**
-     * List of DSR requests to display
-     */
-    requests: DSRRequest[];
-    /**
-     * Callback function called when a request is selected
-     */
-    onSelectRequest?: (requestId: string) => void;
-    /**
-     * Callback function called when a request status is updated
-     */
-    onUpdateStatus?: (requestId: string, status: DSRStatus) => void;
-    /**
-     * Callback function called when a request is assigned
-     */
-    onAssignRequest?: (requestId: string, assignee: string) => void;
-    /**
-     * Title displayed on the dashboard
-     * @default "Data Subject Request Dashboard"
-     */
-    title?: string;
-    /**
-     * Description text displayed on the dashboard
-     * @default "Track and manage data subject requests in compliance with NDPA requirements."
-     */
-    description?: string;
-    /**
-     * Custom CSS class for the dashboard
-     */
-    className?: string;
-    /**
-     * Custom CSS class for the buttons
-     */
-    buttonClassName?: string;
-    /**
-     * Whether to show the request details
-     * @default true
-     */
-    showRequestDetails?: boolean;
-    /**
-     * Whether to show the request timeline
-     * @default true
-     */
-    showRequestTimeline?: boolean;
-    /**
-     * Whether to show the deadline alerts
-     * @default true
-     */
-    showDeadlineAlerts?: boolean;
-    /**
-     * List of possible assignees
-     */
-    assignees?: string[];
-}
-declare const DSRDashboard: React.FC<DSRDashboardProps>;
-
-interface DSRTrackerProps {
-    /**
-     * List of DSR requests to track
-     */
-    requests: DSRRequest[];
-    /**
-     * Callback function called when a request is selected
-     */
-    onSelectRequest?: (requestId: string) => void;
-    /**
-     * Title displayed on the tracker
-     * @default "DSR Request Tracker"
-     */
-    title?: string;
-    /**
-     * Description text displayed on the tracker
-     * @default "Track the status and progress of data subject requests."
-     */
-    description?: string;
-    /**
-     * Custom CSS class for the tracker
-     */
-    className?: string;
-    /**
-     * Custom CSS class for the buttons
-     */
-    buttonClassName?: string;
-    /**
-     * Whether to show the summary statistics
-     * @default true
-     */
-    showSummaryStats?: boolean;
-    /**
-     * Whether to show the request type breakdown
-     * @default true
-     */
-    showTypeBreakdown?: boolean;
-    /**
-     * Whether to show the status breakdown
-     * @default true
-     */
-    showStatusBreakdown?: boolean;
-    /**
-     * Whether to show the timeline chart
-     * @default true
-     */
-    showTimelineChart?: boolean;
-    /**
-     * Whether to show the overdue requests
-     * @default true
-     */
-    showOverdueRequests?: boolean;
-}
-declare const DSRTracker: React.FC<DSRTrackerProps>;
-
-export { DSRDashboard, DSRRequest, DSRRequestForm, DSRStatus, DSRTracker, RequestType };
+export { D as DSRDashboard, a as DSRDashboardClassNames, c as DSRRequestForm, d as DSRRequestFormClassNames, e as DSRTracker, f as DSRTrackerClassNames } from './dsr-BTT-Xd7H.mjs';
+export { u as useDSR } from './useDSR-YYZ6FYFs.mjs';
+export { f as formatDSRRequest } from './dsr-D_eTNc4S.mjs';
+export { D as DSRRequest, a as DSRStatus, b as DSRType, R as RequestStatus, c as RequestType } from './dsr-Cm9lzWG7.mjs';
+import 'react';