@tantainnovative/ndpr-toolkit 2.4.0 → 3.0.0

package/dist/BreachReportForm-DpRrBoxU.d.ts

@@ -0,0 +1,158 @@
+import React__default from 'react';
+import { B as BreachCategory } from './breach-Eu9byel8.js';
+
+/**
+ * Represents the data submitted by the breach report form.
+ */
+interface BreachFormSubmission {
+    /** Title/summary of the breach */
+    title: string;
+    /** Detailed description of the breach */
+    description: string;
+    /** Breach category identifier */
+    category: string;
+    /** Timestamp (ms) when the breach was discovered */
+    discoveredAt: number;
+    /** Timestamp (ms) when the breach occurred (if known) */
+    occurredAt?: number;
+    /** Timestamp (ms) when the form was submitted */
+    reportedAt: number;
+    /** Person reporting the breach */
+    reporter: {
+        name: string;
+        email: string;
+        department: string;
+        phone?: string;
+    };
+    /** Systems or applications affected by the breach */
+    affectedSystems: string[];
+    /** Types of data involved in the breach */
+    dataTypes: string[];
+    /** Estimated number of affected data subjects */
+    estimatedAffectedSubjects?: number;
+    /** Current status of the breach */
+    status: 'ongoing' | 'contained' | 'resolved';
+    /** Initial actions taken to address the breach */
+    initialActions?: string;
+    /** File attachments included with the report */
+    attachments: Array<{
+        name: string;
+        type: string;
+        size: number;
+        file: File;
+    }>;
+}
+interface BreachReportFormClassNames {
+    root?: string;
+    title?: string;
+    form?: string;
+    fieldGroup?: string;
+    label?: string;
+    input?: string;
+    select?: string;
+    textarea?: string;
+    submitButton?: string;
+    /** Alias for submitButton */
+    primaryButton?: string;
+    notice?: string;
+    /** Custom class applied when isSubmitting is true (e.g. a loading overlay) */
+    loadingOverlay?: string;
+}
+interface BreachReportFormProps {
+    /**
+     * Available breach categories
+     */
+    categories: BreachCategory[];
+    /**
+     * Callback function called when form is submitted
+     */
+    onSubmit: (data: BreachFormSubmission) => void;
+    /**
+     * Callback function called when form validation fails
+     */
+    onValidationError?: (errors: Record<string, string>) => void;
+    /**
+     * Title displayed on the form
+     * @default "Report a Data Breach"
+     */
+    title?: string;
+    /**
+     * Description text displayed on the form
+     * @default "Use this form to report a suspected or confirmed data breach in accordance with NDPA Section 40. All fields marked with * are required."
+     */
+    formDescription?: string;
+    /**
+     * Text for the submit button
+     * @default "Submit Report"
+     */
+    submitButtonText?: string;
+    /**
+     * Custom CSS class for the form
+     */
+    className?: string;
+    /**
+     * Custom CSS class for the submit button
+     */
+    buttonClassName?: string;
+    /**
+     * Override class names for individual elements
+     */
+    classNames?: BreachReportFormClassNames;
+    /**
+     * Remove all default styles, only applying classNames overrides
+     */
+    unstyled?: boolean;
+    /**
+     * Whether the form is currently submitting.
+     * When true, the submit button is disabled and shows "Submitting..." text.
+     */
+    isSubmitting?: boolean;
+    /**
+     * Whether to show a confirmation message after submission
+     * @default true
+     */
+    showConfirmation?: boolean;
+    /**
+     * Confirmation message to display after submission
+     * @default "Your breach report has been submitted successfully. The data protection team has been notified."
+     */
+    confirmationMessage?: string;
+    /**
+     * Whether to allow file attachments
+     * @default true
+     */
+    allowAttachments?: boolean;
+    /**
+     * Maximum number of attachments allowed
+     * @default 5
+     */
+    maxAttachments?: number;
+    /**
+     * Maximum file size for attachments (in bytes)
+     * @default 5242880 (5MB)
+     */
+    maxFileSize?: number;
+    /**
+     * Allowed file types for attachments
+     * @default ['.pdf', '.jpg', '.jpeg', '.png', '.doc', '.docx', '.xls', '.xlsx', '.txt']
+     */
+    allowedFileTypes?: string[];
+    /**
+     * Default values to pre-fill form fields.
+     * Useful for editing existing breach reports or pre-populating known data.
+     */
+    defaultValues?: Partial<BreachFormSubmission>;
+    /**
+     * 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;
+}
+/**
+ * Breach report form component. Implements NDPA Section 40 breach notification requirements,
+ * enabling organizations to document and report data breaches within the mandated 72-hour window.
+ */
+declare const BreachReportForm: React__default.FC<BreachReportFormProps>;
+
+export { type BreachFormSubmission as B, BreachReportForm as a, type BreachReportFormClassNames as b, type BreachReportFormProps as c };

package/dist/BreachReportForm-yJ2Zl6gz.d.mts

@@ -0,0 +1,158 @@
+import React__default from 'react';
+import { B as BreachCategory } from './breach-Eu9byel8.mjs';
+
+/**
+ * Represents the data submitted by the breach report form.
+ */
+interface BreachFormSubmission {
+    /** Title/summary of the breach */
+    title: string;
+    /** Detailed description of the breach */
+    description: string;
+    /** Breach category identifier */
+    category: string;
+    /** Timestamp (ms) when the breach was discovered */
+    discoveredAt: number;
+    /** Timestamp (ms) when the breach occurred (if known) */
+    occurredAt?: number;
+    /** Timestamp (ms) when the form was submitted */
+    reportedAt: number;
+    /** Person reporting the breach */
+    reporter: {
+        name: string;
+        email: string;
+        department: string;
+        phone?: string;
+    };
+    /** Systems or applications affected by the breach */
+    affectedSystems: string[];
+    /** Types of data involved in the breach */
+    dataTypes: string[];
+    /** Estimated number of affected data subjects */
+    estimatedAffectedSubjects?: number;
+    /** Current status of the breach */
+    status: 'ongoing' | 'contained' | 'resolved';
+    /** Initial actions taken to address the breach */
+    initialActions?: string;
+    /** File attachments included with the report */
+    attachments: Array<{
+        name: string;
+        type: string;
+        size: number;
+        file: File;
+    }>;
+}
+interface BreachReportFormClassNames {
+    root?: string;
+    title?: string;
+    form?: string;
+    fieldGroup?: string;
+    label?: string;
+    input?: string;
+    select?: string;
+    textarea?: string;
+    submitButton?: string;
+    /** Alias for submitButton */
+    primaryButton?: string;
+    notice?: string;
+    /** Custom class applied when isSubmitting is true (e.g. a loading overlay) */
+    loadingOverlay?: string;
+}
+interface BreachReportFormProps {
+    /**
+     * Available breach categories
+     */
+    categories: BreachCategory[];
+    /**
+     * Callback function called when form is submitted
+     */
+    onSubmit: (data: BreachFormSubmission) => void;
+    /**
+     * Callback function called when form validation fails
+     */
+    onValidationError?: (errors: Record<string, string>) => void;
+    /**
+     * Title displayed on the form
+     * @default "Report a Data Breach"
+     */
+    title?: string;
+    /**
+     * Description text displayed on the form
+     * @default "Use this form to report a suspected or confirmed data breach in accordance with NDPA Section 40. All fields marked with * are required."
+     */
+    formDescription?: string;
+    /**
+     * Text for the submit button
+     * @default "Submit Report"
+     */
+    submitButtonText?: string;
+    /**
+     * Custom CSS class for the form
+     */
+    className?: string;
+    /**
+     * Custom CSS class for the submit button
+     */
+    buttonClassName?: string;
+    /**
+     * Override class names for individual elements
+     */
+    classNames?: BreachReportFormClassNames;
+    /**
+     * Remove all default styles, only applying classNames overrides
+     */
+    unstyled?: boolean;
+    /**
+     * Whether the form is currently submitting.
+     * When true, the submit button is disabled and shows "Submitting..." text.
+     */
+    isSubmitting?: boolean;
+    /**
+     * Whether to show a confirmation message after submission
+     * @default true
+     */
+    showConfirmation?: boolean;
+    /**
+     * Confirmation message to display after submission
+     * @default "Your breach report has been submitted successfully. The data protection team has been notified."
+     */
+    confirmationMessage?: string;
+    /**
+     * Whether to allow file attachments
+     * @default true
+     */
+    allowAttachments?: boolean;
+    /**
+     * Maximum number of attachments allowed
+     * @default 5
+     */
+    maxAttachments?: number;
+    /**
+     * Maximum file size for attachments (in bytes)
+     * @default 5242880 (5MB)
+     */
+    maxFileSize?: number;
+    /**
+     * Allowed file types for attachments
+     * @default ['.pdf', '.jpg', '.jpeg', '.png', '.doc', '.docx', '.xls', '.xlsx', '.txt']
+     */
+    allowedFileTypes?: string[];
+    /**
+     * Default values to pre-fill form fields.
+     * Useful for editing existing breach reports or pre-populating known data.
+     */
+    defaultValues?: Partial<BreachFormSubmission>;
+    /**
+     * 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;
+}
+/**
+ * Breach report form component. Implements NDPA Section 40 breach notification requirements,
+ * enabling organizations to document and report data breaches within the mandated 72-hour window.
+ */
+declare const BreachReportForm: React__default.FC<BreachReportFormProps>;
+
+export { type BreachFormSubmission as B, BreachReportForm as a, type BreachReportFormClassNames as b, type BreachReportFormProps as c };

package/dist/ConsentBanner-CDRT0o2k.d.mts

@@ -0,0 +1,146 @@
+import React__default from 'react';
+import { C as ConsentOption, a as ConsentSettings } from './consent-CmVzqZUk.mjs';
+
+interface ConsentAnalyticsEvent {
+    action: 'shown' | 'accepted_all' | 'rejected_all' | 'customized' | 'dismissed';
+    timestamp: number;
+    version: string;
+    categories?: Record<string, boolean>;
+}
+interface ConsentBannerClassNames {
+    root?: string;
+    container?: string;
+    title?: string;
+    description?: string;
+    optionsList?: string;
+    optionItem?: string;
+    optionCheckbox?: string;
+    optionLabel?: string;
+    optionDescription?: string;
+    buttonGroup?: string;
+    acceptButton?: string;
+    rejectButton?: string;
+    customizeButton?: string;
+    saveButton?: string;
+    customizePanel?: string;
+    selectAllButton?: string;
+    /** Alias for acceptButton */
+    primaryButton?: string;
+    /** Alias for rejectButton */
+    secondaryButton?: string;
+}
+interface ConsentBannerProps {
+    /**
+     * Array of consent options to display
+     */
+    options: ConsentOption[];
+    /**
+     * Callback function called when user saves their consent choices
+     */
+    onSave: (settings: ConsentSettings) => void;
+    /**
+     * Title displayed on the banner
+     * @default "We Value Your Privacy"
+     */
+    title?: string;
+    /**
+     * Description text displayed on the banner
+     * @default "We use cookies and similar technologies to provide our services and enhance your experience. Your consent is collected in accordance with NDPA Sections 25-26."
+     */
+    description?: string;
+    /**
+     * Text for the accept all button
+     * @default "Accept All"
+     */
+    acceptAllButtonText?: string;
+    /**
+     * Text for the reject all button
+     * @default "Reject All"
+     */
+    rejectAllButtonText?: string;
+    /**
+     * Text for the customize button
+     * @default "Customize"
+     */
+    customizeButtonText?: string;
+    /**
+     * Text for the save button
+     * @default "Save Preferences"
+     */
+    saveButtonText?: string;
+    /**
+     * Position of the banner.
+     * 'top', 'bottom', and 'center' render via a portal to document.body
+     * with fixed positioning so the banner overlays the page.
+     * 'inline' renders in the normal DOM tree without a portal.
+     * @default "bottom"
+     */
+    position?: 'top' | 'bottom' | 'center' | 'inline';
+    /**
+     * z-index applied to the fixed-position banner.
+     * Ignored when position is 'inline'.
+     * @default 9999
+     */
+    zIndex?: number;
+    /**
+     * Version of the consent form
+     * @default "1.0"
+     */
+    version?: string;
+    /**
+     * Whether to show the banner
+     * If not provided, the banner will be shown if no consent has been saved
+     */
+    show?: boolean;
+    /**
+     * Storage key for consent settings
+     * @default "ndpr_consent"
+     */
+    storageKey?: string;
+    /**
+     * Whether the banner manages its own localStorage persistence.
+     * Set to false when an external storage mechanism (e.g., ConsentStorage)
+     * is responsible for persisting consent settings under the same key.
+     * This avoids race conditions where two writers target the same storage key.
+     * @default true
+     */
+    manageStorage?: boolean;
+    /**
+     * Custom CSS class for the banner
+     */
+    className?: string;
+    /**
+     * Custom CSS class for the buttons
+     */
+    buttonClassName?: string;
+    /**
+     * Custom CSS class for the primary button
+     */
+    primaryButtonClassName?: string;
+    /**
+     * Custom CSS class for the secondary button
+     */
+    secondaryButtonClassName?: string;
+    /**
+     * Object of CSS class overrides keyed by semantic section name.
+     * Takes priority over buttonClassName / primaryButtonClassName / secondaryButtonClassName.
+     */
+    classNames?: ConsentBannerClassNames;
+    /**
+     * When true, all default Tailwind classes are removed so consumers
+     * can style from scratch using classNames.
+     */
+    unstyled?: boolean;
+    /**
+     * Optional analytics callback fired on each user interaction.
+     * Called when the banner is shown, accepted, rejected, customized, or dismissed.
+     */
+    onAnalytics?: (event: ConsentAnalyticsEvent) => void;
+}
+/**
+ * Consent banner component. Implements NDPA Sections 25-26 consent requirements
+ * for obtaining and managing data subject consent.
+ */
+declare const ConsentBanner: React__default.FC<ConsentBannerProps>;
+
+export { type ConsentAnalyticsEvent as C, ConsentBanner as a, type ConsentBannerClassNames as b, type ConsentBannerProps as c };

package/dist/ConsentBanner-Vxyt8SCX.d.ts

@@ -0,0 +1,146 @@
+import React__default from 'react';
+import { C as ConsentOption, a as ConsentSettings } from './consent-CmVzqZUk.js';
+
+interface ConsentAnalyticsEvent {
+    action: 'shown' | 'accepted_all' | 'rejected_all' | 'customized' | 'dismissed';
+    timestamp: number;
+    version: string;
+    categories?: Record<string, boolean>;
+}
+interface ConsentBannerClassNames {
+    root?: string;
+    container?: string;
+    title?: string;
+    description?: string;
+    optionsList?: string;
+    optionItem?: string;
+    optionCheckbox?: string;
+    optionLabel?: string;
+    optionDescription?: string;
+    buttonGroup?: string;
+    acceptButton?: string;
+    rejectButton?: string;
+    customizeButton?: string;
+    saveButton?: string;
+    customizePanel?: string;
+    selectAllButton?: string;
+    /** Alias for acceptButton */
+    primaryButton?: string;
+    /** Alias for rejectButton */
+    secondaryButton?: string;
+}
+interface ConsentBannerProps {
+    /**
+     * Array of consent options to display
+     */
+    options: ConsentOption[];
+    /**
+     * Callback function called when user saves their consent choices
+     */
+    onSave: (settings: ConsentSettings) => void;
+    /**
+     * Title displayed on the banner
+     * @default "We Value Your Privacy"
+     */
+    title?: string;
+    /**
+     * Description text displayed on the banner
+     * @default "We use cookies and similar technologies to provide our services and enhance your experience. Your consent is collected in accordance with NDPA Sections 25-26."
+     */
+    description?: string;
+    /**
+     * Text for the accept all button
+     * @default "Accept All"
+     */
+    acceptAllButtonText?: string;
+    /**
+     * Text for the reject all button
+     * @default "Reject All"
+     */
+    rejectAllButtonText?: string;
+    /**
+     * Text for the customize button
+     * @default "Customize"
+     */
+    customizeButtonText?: string;
+    /**
+     * Text for the save button
+     * @default "Save Preferences"
+     */
+    saveButtonText?: string;
+    /**
+     * Position of the banner.
+     * 'top', 'bottom', and 'center' render via a portal to document.body
+     * with fixed positioning so the banner overlays the page.
+     * 'inline' renders in the normal DOM tree without a portal.
+     * @default "bottom"
+     */
+    position?: 'top' | 'bottom' | 'center' | 'inline';
+    /**
+     * z-index applied to the fixed-position banner.
+     * Ignored when position is 'inline'.
+     * @default 9999
+     */
+    zIndex?: number;
+    /**
+     * Version of the consent form
+     * @default "1.0"
+     */
+    version?: string;
+    /**
+     * Whether to show the banner
+     * If not provided, the banner will be shown if no consent has been saved
+     */
+    show?: boolean;
+    /**
+     * Storage key for consent settings
+     * @default "ndpr_consent"
+     */
+    storageKey?: string;
+    /**
+     * Whether the banner manages its own localStorage persistence.
+     * Set to false when an external storage mechanism (e.g., ConsentStorage)
+     * is responsible for persisting consent settings under the same key.
+     * This avoids race conditions where two writers target the same storage key.
+     * @default true
+     */
+    manageStorage?: boolean;
+    /**
+     * Custom CSS class for the banner
+     */
+    className?: string;
+    /**
+     * Custom CSS class for the buttons
+     */
+    buttonClassName?: string;
+    /**
+     * Custom CSS class for the primary button
+     */
+    primaryButtonClassName?: string;
+    /**
+     * Custom CSS class for the secondary button
+     */
+    secondaryButtonClassName?: string;
+    /**
+     * Object of CSS class overrides keyed by semantic section name.
+     * Takes priority over buttonClassName / primaryButtonClassName / secondaryButtonClassName.
+     */
+    classNames?: ConsentBannerClassNames;
+    /**
+     * When true, all default Tailwind classes are removed so consumers
+     * can style from scratch using classNames.
+     */
+    unstyled?: boolean;
+    /**
+     * Optional analytics callback fired on each user interaction.
+     * Called when the banner is shown, accepted, rejected, customized, or dismissed.
+     */
+    onAnalytics?: (event: ConsentAnalyticsEvent) => void;
+}
+/**
+ * Consent banner component. Implements NDPA Sections 25-26 consent requirements
+ * for obtaining and managing data subject consent.
+ */
+declare const ConsentBanner: React__default.FC<ConsentBannerProps>;
+
+export { type ConsentAnalyticsEvent as C, ConsentBanner as a, type ConsentBannerClassNames as b, type ConsentBannerProps as c };

package/dist/{cross-border-entry-BrWVPly6.d.ts → CrossBorderTransferManager-D5Lc0e46.d.ts}

@@ -1,6 +1,5 @@
-import React from 'react';
-import { a as CrossBorderTransfer, C as CrossBorderSummary } from './cross-border-BMcqLvjC.js';
-import './useCrossBorderTransfer-DmtACeqW.js';
+import React__default from 'react';
+import { a as CrossBorderTransfer, C as CrossBorderSummary } from './cross-border-UyT00llA.js';
 
 interface CrossBorderTransferManagerClassNames {
     root?: string;
@@ -86,6 +85,6 @@ interface CrossBorderTransferManagerProps {
  * for managing international data transfers, including adequacy decisions, standard contractual
  * clauses, and NDPC authorization.
  */
-declare const CrossBorderTransferManager: React.FC<CrossBorderTransferManagerProps>;
+declare const CrossBorderTransferManager: React__default.FC<CrossBorderTransferManagerProps>;
 
-export { CrossBorderTransferManager as C, type CrossBorderTransferManagerClassNames as a };
+export { CrossBorderTransferManager as C, type CrossBorderTransferManagerClassNames as a, type CrossBorderTransferManagerProps as b };

package/dist/{cross-border-entry-cCTvpwnT.d.mts → CrossBorderTransferManager-DkZhv9vD.d.mts}

@@ -1,6 +1,5 @@
-import React from 'react';
-import { a as CrossBorderTransfer, C as CrossBorderSummary } from './cross-border-BMcqLvjC.mjs';
-import './useCrossBorderTransfer-BZVFCXfr.mjs';
+import React__default from 'react';
+import { a as CrossBorderTransfer, C as CrossBorderSummary } from './cross-border-UyT00llA.mjs';
 
 interface CrossBorderTransferManagerClassNames {
     root?: string;
@@ -86,6 +85,6 @@ interface CrossBorderTransferManagerProps {
  * for managing international data transfers, including adequacy decisions, standard contractual
  * clauses, and NDPC authorization.
  */
-declare const CrossBorderTransferManager: React.FC<CrossBorderTransferManagerProps>;
+declare const CrossBorderTransferManager: React__default.FC<CrossBorderTransferManagerProps>;
 
-export { CrossBorderTransferManager as C, type CrossBorderTransferManagerClassNames as a };
+export { CrossBorderTransferManager as C, type CrossBorderTransferManagerClassNames as a, type CrossBorderTransferManagerProps as b };