@compass-ai/nova 1.0.73 → 1.0.74

package/dist/services/consent-manager.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Consent management service for GDPR-compliant consent collection, version tracking,
+ * status queries, and data cleanup on revocation.
+ *
+ * This module provides comprehensive consent management functionality for the Compass CLI,
+ * ensuring compliance with GDPR requirements including:
+ * - Explicit consent collection before any data processing
+ * - Granular control over different consent types (data collection, telemetry, analytics, error reporting)
+ * - Consent version tracking for re-consent on policy updates
+ * - Data subject rights (access, portability, erasure)
+ * - Automatic consent expiration and renewal prompts
+ * - Complete data cleanup on consent revocation
+ */
+import { Consent, ConsentRecord, ConsentStatus } from '../types/consent.js';
+/**
+ * ConsentManager class provides GDPR-compliant consent management.
+ *
+ * Features:
+ * - Consent collection with explicit user agreement
+ * - Version tracking for policy updates
+ * - Automatic expiration after configurable period
+ * - Complete consent history for audit purposes
+ * - Data cleanup on consent revocation
+ * - User data export for portability
+ */
+declare class ConsentManager {
+    private history;
+    private loaded;
+    /**
+     * Loads consent history from disk.
+     * Called automatically when needed, but can be called explicitly.
+     */
+    load(): Promise<void>;
+    /**
+     * Gets the current consent status.
+     *
+     * @returns ConsentStatus object with validity, consent settings, and expiration info
+     *
+     * @example
+     * ```typescript
+     * const consentManager = await getConsentManager();
+     * const status = await consentManager.getStatus();
+     *
+     * if (!status.isValid) {
+     *   console.log('Consent required');
+     * }
+     *
+     * if (status.needsRenewal) {
+     *   console.log('Consent needs renewal');
+     * }
+     * ```
+     */
+    getStatus(): Promise<ConsentStatus>;
+    /**
+     * Grants consent with the specified options.
+     * Creates a new consent record and saves it to disk.
+     *
+     * @param consent - The consent settings to grant
+     * @returns The created ConsentRecord
+     *
+     * @example
+     * ```typescript
+     * const consentManager = await getConsentManager();
+     * const record = await consentManager.grantConsent({
+     *   dataCollection: true,
+     *   telemetry: false,
+     *   analytics: false,
+     *   errorReporting: true,
+     * });
+     *
+     * console.log(`Consent granted: ${record.id}`);
+     * console.log(`Expires: ${record.expiresAt}`);
+     * ```
+     */
+    grantConsent(consent: Consent): Promise<ConsentRecord>;
+    /**
+     * Revokes consent and cleans up all user data.
+     * This implements the GDPR Right to Erasure.
+     *
+     * @example
+     * ```typescript
+     * const consentManager = await getConsentManager();
+     * await consentManager.revokeConsent();
+     * console.log('All data has been deleted');
+     * ```
+     */
+    revokeConsent(): Promise<void>;
+    /**
+     * Updates consent settings while preserving the consent record.
+     * Creates a new consent record with updated settings.
+     *
+     * @param updates - Partial consent settings to update
+     * @returns The new ConsentRecord or null if no current consent exists
+     *
+     * @example
+     * ```typescript
+     * const consentManager = await getConsentManager();
+     * const record = await consentManager.updateConsent({
+     *   telemetry: true,
+     * });
+     * ```
+     */
+    updateConsent(updates: Partial<Consent>): Promise<ConsentRecord | null>;
+    /**
+     * Gets the complete consent history for audit purposes.
+     *
+     * @returns Array of all ConsentRecord objects
+     *
+     * @example
+     * ```typescript
+     * const consentManager = await getConsentManager();
+     * const history = consentManager.getHistory();
+     *
+     * for (const record of history) {
+     *   console.log(`${record.grantedAt}: Version ${record.version}`);
+     * }
+     * ```
+     */
+    getHistory(): ConsentRecord[];
+    /**
+     * Exports all user data for GDPR data portability.
+     * Collects data from all Compass storage locations.
+     *
+     * @returns Object containing all exportable user data
+     *
+     * @example
+     * ```typescript
+     * const consentManager = await getConsentManager();
+     * const data = await consentManager.exportUserData();
+     *
+     * // Save to file
+     * await fs.writeFile('compass-data.json', JSON.stringify(data, null, 2));
+     * ```
+     */
+    exportUserData(): Promise<Record<string, unknown>>;
+    /**
+     * Checks if data collection is allowed based on current consent.
+     *
+     * @returns True if data collection is consented and valid
+     *
+     * @example
+     * ```typescript
+     * const consentManager = await getConsentManager();
+     * if (await consentManager.isDataCollectionAllowed()) {
+     *   // Proceed with data collection
+     * }
+     * ```
+     */
+    isDataCollectionAllowed(): Promise<boolean>;
+    /**
+     * Checks if telemetry is allowed based on current consent.
+     *
+     * @returns True if telemetry is consented and valid
+     *
+     * @example
+     * ```typescript
+     * const consentManager = await getConsentManager();
+     * if (await consentManager.isTelemetryAllowed()) {
+     *   // Send telemetry data
+     * }
+     * ```
+     */
+    isTelemetryAllowed(): Promise<boolean>;
+    /**
+     * Checks if analytics is allowed based on current consent.
+     *
+     * @returns True if analytics is consented and valid
+     */
+    isAnalyticsAllowed(): Promise<boolean>;
+    /**
+     * Checks if error reporting is allowed based on current consent.
+     *
+     * @returns True if error reporting is consented and valid
+     */
+    isErrorReportingAllowed(): Promise<boolean>;
+    /**
+     * Checks if any valid consent exists.
+     *
+     * @returns True if there is valid, non-expired consent
+     */
+    hasValidConsent(): Promise<boolean>;
+    /**
+     * Gets the current consent record if one exists.
+     *
+     * @returns The current ConsentRecord or null
+     */
+    getCurrentRecord(): ConsentRecord | null;
+    /**
+     * Gets the path to the consent file.
+     *
+     * @returns Absolute path to the consent.json file
+     */
+    private getConsentFilePath;
+    /**
+     * Saves the consent history to disk.
+     */
+    private save;
+    /**
+     * Cleans up all user data when consent is revoked.
+     * Implements GDPR Right to Erasure.
+     */
+    private cleanupUserData;
+    /**
+     * Reloads consent data from disk.
+     * Useful after external modifications.
+     */
+    reload(): Promise<void>;
+    /**
+     * Clears the in-memory consent data without affecting disk storage.
+     * Primarily used for testing.
+     */
+    reset(): void;
+}
+/**
+ * Gets the singleton ConsentManager instance.
+ * Automatically loads consent data on first access.
+ *
+ * @returns Promise resolving to the ConsentManager instance
+ *
+ * @example
+ * ```typescript
+ * const consentManager = await getConsentManager();
+ * const status = await consentManager.getStatus();
+ *
+ * if (!status.isValid) {
+ *   // Prompt user for consent
+ * }
+ * ```
+ */
+export declare function getConsentManager(): Promise<ConsentManager>;
+/**
+ * Creates a new ConsentManager instance without loading data.
+ * Use this when you need a separate instance from the singleton.
+ *
+ * @returns A new ConsentManager instance
+ */
+export declare function createConsentManager(): ConsentManager;
+export { ConsentManager };
+//# sourceMappingURL=consent-manager.d.ts.map

package/dist/services/consent-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent-manager.d.ts","sourceRoot":"","sources":["../../src/services/consent-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EACL,OAAO,EACP,aAAa,EAEb,aAAa,EAEd,MAAM,qBAAqB,CAAC;AAkB7B;;;;;;;;;;GAUG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,OAAO,CAGb;IACF,OAAO,CAAC,MAAM,CAAkB;IAEhC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3B;;;;;;;;;;;;;;;;;;OAkBG;IACG,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IA8CzC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IA+C5D;;;;;;;;;;OAUG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBpC;;;;;;;;;;;;;;OAcG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAsB7E;;;;;;;;;;;;;;OAcG;IACH,UAAU,IAAI,aAAa,EAAE;IAI7B;;;;;;;;;;;;;;OAcG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAoExD;;;;;;;;;;;;OAYG;IACG,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKjD;;;;;;;;;;;;OAYG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAK5C;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAK5C;;;;OAIG;IACG,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKjD;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKzC;;;;OAIG;IACH,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAWxC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;YACW,IAAI;IAUlB;;;OAGG;YACW,eAAe;IAgC7B;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B;;;OAGG;IACH,KAAK,IAAI,IAAI;CAOd;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAMjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}