content-security-toolkit 1.0.0

package/dist/strategies/DevToolsStrategy-detectorManager.js

@@ -0,0 +1,309 @@
+import { isBrowser } from "../utils/detection";
+import { ProtectedContentManager } from "../utils/protectedContentManager";
+import { SecurityOverlayManager } from "../utils/securityOverlayManager";
+import { intervalManager } from "../utils/intervalManager";
+import { AbstractStrategy, StrategyErrorType } from "./AbstractStrategy";
+import { DevToolsDetectorManager } from "../utils/detectors/devToolsDetectorManager";
+/**
+ * Strategy for detecting and responding to DevTools usage
+ */
+export class DevToolsStrategy extends AbstractStrategy {
+    /**
+     * Create a new DevToolsStrategy
+     * @param options Options for customizing the DevTools protection
+     * @param targetElement Element containing sensitive content
+     * @param customHandler Optional custom handler for DevTools detection
+     * @param debugMode Enable debug mode for troubleshooting
+     */
+    constructor(options, targetElement = null, customHandler, debugMode = false) {
+        super("DevToolsStrategy", debugMode);
+        this.taskId = null;
+        this.isDevToolsOpen = false;
+        this.targetElement = null;
+        this.contentManager = null;
+        // DevTools detection manager
+        this.detectorManager = null;
+        this.options = {
+            overlayOptions: {
+                title: "Developer Tools Detected",
+                message: "For security reasons, this content is not available while developer tools are open.",
+                secondaryMessage: "Please close developer tools to continue viewing this content.",
+                textColor: "white",
+                backgroundColor: "rgba(255, 0, 0, 0.7)",
+            },
+            showOverlay: true,
+            checkFrequency: 1000,
+            hideContent: false,
+            detectorTypes: [], // Empty array means use default detectors for the browser
+            ...options,
+        };
+        this.targetElement = targetElement;
+        this.customHandler = customHandler;
+        // Initialize content manager if target element is provided
+        if (targetElement) {
+            this.contentManager = new ProtectedContentManager(targetElement, debugMode);
+        }
+        // Initialize overlay manager
+        this.overlayManager = new SecurityOverlayManager(debugMode);
+        this.log("Initialized with checkFrequency:", this.options.checkFrequency);
+        // Initialize the detector manager
+        this.initDetectorManager();
+    }
+    /**
+     * Initialize the detector manager
+     */
+    initDetectorManager() {
+        return this.safeExecute("initDetectorManager", StrategyErrorType.INITIALIZATION, () => {
+            if (!isBrowser())
+                return;
+            try {
+                this.detectorManager = new DevToolsDetectorManager({
+                    debuggerTimeoutDuration: 80, // 80ms timeout for debugger detection
+                    onDevToolsChange: (isOpen) => {
+                        this.handleDevToolsStateChange(isOpen);
+                    },
+                    debugMode: this.debugMode,
+                    enabledDetectors: this.options.detectorTypes,
+                    checkInterval: this.options.checkFrequency,
+                });
+                this.log("Detector manager initialized");
+            }
+            catch (error) {
+                this.handleError(StrategyErrorType.INITIALIZATION, "Failed to initialize detector manager", error);
+            }
+        });
+    }
+    /**
+     * Handle DevTools state changes from any detection method
+     */
+    handleDevToolsStateChange(isOpen) {
+        return this.safeExecute("handleDevToolsStateChange", StrategyErrorType.APPLICATION, () => {
+            // Only take action if state has changed
+            if (isOpen !== this.isDevToolsOpen) {
+                this.isDevToolsOpen = isOpen;
+                this.log(`DevTools state changed: ${isOpen ? "open" : "closed"}`);
+                if (isOpen) {
+                    this.applyDevToolsProtection();
+                }
+                else {
+                    this.removeDevToolsProtection();
+                }
+                // Call custom handler if provided
+                if (this.customHandler) {
+                    this.customHandler(isOpen);
+                }
+            }
+        });
+    }
+    /**
+     * Start monitoring for DevTools usage
+     */
+    startMonitoring() {
+        return this.safeExecute("startMonitoring", StrategyErrorType.APPLICATION, () => {
+            if (typeof window === "undefined")
+                return;
+            this.log("Starting DevTools monitoring");
+            // Register with IntervalManager for periodic checks
+            this.taskId = intervalManager.registerTask("devtools-detection", () => this.safeExecute("intervalTask", StrategyErrorType.APPLICATION, () => {
+                // Use detector manager for detection
+                if (this.detectorManager) {
+                    this.detectorManager.checkDevTools();
+                }
+                // Always check overlay state if DevTools are open
+                if (this.isDevToolsOpen) {
+                    this.overlayManager.checkAndRestoreOverlay();
+                }
+            }), this.options.checkFrequency);
+            // Force initial check
+            if (this.detectorManager) {
+                this.detectorManager.checkDevTools();
+            }
+        });
+    }
+    /**
+     * Apply DevTools protection by creating overlay and event blocker
+     */
+    applyDevToolsProtection() {
+        return this.safeExecute("applyDevToolsProtection", StrategyErrorType.APPLICATION, () => {
+            if (!isBrowser())
+                return;
+            if (this.options.hideContent) {
+                // Hide sensitive content
+                this.hideSensitiveContent();
+            }
+            if (this.options.showOverlay) {
+                // Create overlay using the overlay manager
+                this.overlayManager.showOverlay({
+                    ...this.options.overlayOptions,
+                    blockEvents: true, // Block all events
+                    autoRestore: true, // Restore overlay if removed from DOM
+                });
+            }
+            this.log("DevTools protection applied");
+        });
+    }
+    /**
+     * Hide sensitive content when DevTools is open
+     */
+    hideSensitiveContent() {
+        return this.safeExecute("hideSensitiveContent", StrategyErrorType.APPLICATION, () => {
+            if (!this.targetElement || !this.contentManager)
+                return;
+            this.contentManager.hideContent({
+                title: this.options.overlayOptions?.title,
+                message: this.options.overlayOptions?.message,
+                secondaryMessage: this.options.overlayOptions?.secondaryMessage,
+                textColor: "black",
+                backgroundColor: "rgba(0, 0, 0, 0.05)",
+            });
+            this.log("Sensitive content hidden");
+        });
+    }
+    /**
+     * Restore sensitive content when DevTools is closed
+     */
+    restoreSensitiveContent() {
+        return this.safeExecute("restoreSensitiveContent", StrategyErrorType.REMOVAL, () => {
+            if (!this.contentManager)
+                return;
+            this.contentManager.restoreContent();
+            this.log("Sensitive content restored");
+        });
+    }
+    /**
+     * Remove DevTools protection
+     */
+    removeDevToolsProtection() {
+        return this.safeExecute("removeDevToolsProtection", StrategyErrorType.REMOVAL, () => {
+            if (typeof document === "undefined")
+                return;
+            if (this.options.hideContent) {
+                // Restore sensitive content
+                this.restoreSensitiveContent();
+            }
+            if (this.options.showOverlay) {
+                // Remove overlay using the overlay manager
+                this.overlayManager.removeOverlay();
+            }
+            this.log("DevTools protection removed");
+        });
+    }
+    /**
+     * Apply the protection strategy
+     */
+    apply() {
+        return this.safeExecute("apply", StrategyErrorType.APPLICATION, () => {
+            if (this.isAppliedFlag) {
+                this.log("Protection already applied");
+                return;
+            }
+            this.startMonitoring();
+            this.isAppliedFlag = true;
+            this.log("Protection applied");
+        });
+    }
+    /**
+     * Remove the protection strategy
+     * Override the base implementation to handle additional cleanup
+     */
+    remove() {
+        return this.safeExecute("remove", StrategyErrorType.REMOVAL, () => {
+            if (!this.isAppliedFlag) {
+                this.log("Protection not applied");
+                return;
+            }
+            // Clean up the detector manager
+            if (this.detectorManager) {
+                this.detectorManager.dispose();
+                this.detectorManager = null;
+            }
+            // Clear interval via IntervalManager
+            if (this.taskId !== null) {
+                intervalManager.unregisterTask(this.taskId);
+                this.taskId = null;
+                this.log("Interval task unregistered");
+            }
+            // Call the parent class remove method to handle event cleanup
+            super.remove();
+            // Remove protections
+            this.removeDevToolsProtection();
+            this.isAppliedFlag = false;
+            this.isDevToolsOpen = false;
+            this.log("Protection removed");
+        });
+    }
+    /**
+     * Update DevTools protection options
+     * @param options New options
+     */
+    updateOptions(options) {
+        return this.safeExecute("updateOptions", StrategyErrorType.OPTION_UPDATE, () => {
+            const typedOptions = options;
+            this.log("Updating options", typedOptions);
+            // Store previous options for comparison
+            const previousOptions = { ...this.options };
+            this.options = {
+                ...this.options,
+                ...typedOptions,
+            };
+            // If protection is already applied, update the overlay if needed
+            if (this.isAppliedFlag && this.isDevToolsOpen) {
+                // Check if any visual options changed
+                const visualOptionsChanged = previousOptions.overlayOptions?.title !== this.options.overlayOptions?.title ||
+                    previousOptions.overlayOptions?.message !== this.options.overlayOptions?.message ||
+                    previousOptions.overlayOptions?.secondaryMessage !== this.options.overlayOptions?.secondaryMessage ||
+                    previousOptions.overlayOptions?.backgroundColor !== this.options.overlayOptions?.backgroundColor ||
+                    previousOptions.overlayOptions?.textColor !== this.options.overlayOptions?.textColor;
+                if (visualOptionsChanged) {
+                    this.removeDevToolsProtection();
+                    this.applyDevToolsProtection();
+                    this.log("Reapplied protection with updated visual options");
+                }
+            }
+            // Update check frequency if it changed
+            if (typedOptions.checkFrequency &&
+                this.taskId !== null &&
+                previousOptions.checkFrequency !== typedOptions.checkFrequency) {
+                // Unregister and re-register with new frequency
+                intervalManager.unregisterTask(this.taskId);
+                this.taskId = intervalManager.registerTask("devtools-detection", () => this.safeExecute("intervalTask", StrategyErrorType.APPLICATION, () => {
+                    // Use detector manager
+                    if (this.detectorManager) {
+                        this.detectorManager.checkDevTools();
+                    }
+                    if (this.isDevToolsOpen) {
+                        this.overlayManager.checkAndRestoreOverlay();
+                    }
+                }), this.options.checkFrequency);
+                this.log(`Check frequency updated to ${this.options.checkFrequency}ms`);
+            }
+            // If detector types changed, reinitialize the detector manager
+            if (typedOptions.detectorTypes &&
+                JSON.stringify(previousOptions.detectorTypes) !== JSON.stringify(typedOptions.detectorTypes)) {
+                if (this.detectorManager) {
+                    this.detectorManager.dispose();
+                }
+                this.initDetectorManager();
+                this.log("Reinitialized detector manager with new detector types");
+            }
+        });
+    }
+    /**
+     * Set debug mode
+     * @param enabled Whether debug mode should be enabled
+     */
+    setDebugMode(enabled) {
+        return this.safeExecute("setDebugMode", StrategyErrorType.OPTION_UPDATE, () => {
+            super.setDebugMode(enabled);
+            // Update debug mode for the detector manager
+            if (this.detectorManager) {
+                this.detectorManager.setDebugMode(enabled);
+            }
+            // Also update debug mode for managers
+            if (this.contentManager && this.targetElement) {
+                this.contentManager = new ProtectedContentManager(this.targetElement, enabled);
+            }
+            this.overlayManager = new SecurityOverlayManager(enabled);
+        });
+    }
+}

package/dist/strategies/DevToolsStrategy-simple.d.ts

@@ -0,0 +1,75 @@
+import type { CustomEventHandlers, DevToolsOptions } from "../types";
+import { AbstractStrategy } from "./AbstractStrategy";
+/**
+ * Strategy for detecting and responding to DevTools usage
+ */
+export declare class DevToolsStrategy extends AbstractStrategy {
+    private intervalId;
+    private taskId;
+    private customHandler?;
+    private isDevToolsOpen;
+    private targetElement;
+    private options;
+    private contentManager;
+    private overlayManager;
+    private browserInfo;
+    private debuggerDetector;
+    private timingDetector;
+    private dateToStringDetector;
+    private activeDetector;
+    /**
+     * Create a new DevToolsStrategy
+     * @param options Options for customizing the DevTools protection
+     * @param targetElement Element containing sensitive content
+     * @param customHandler Optional custom handler for DevTools detection
+     * @param debugMode Enable debug mode for troubleshooting
+     */
+    constructor(options?: DevToolsOptions, targetElement?: HTMLElement | null, customHandler?: CustomEventHandlers["onDevToolsOpen"], debugMode?: boolean);
+    /**
+     * Initialize the appropriate detector based on browser
+     */
+    private initDetectors;
+    /**
+     * Handle DevTools state changes from any detection method
+     */
+    private handleDevToolsStateChange;
+    /**
+     * Start monitoring for DevTools usage
+     */
+    private startMonitoring;
+    /**
+     * Apply DevTools protection by creating overlay and event blocker
+     */
+    private applyDevToolsProtection;
+    /**
+     * Hide sensitive content when DevTools is open
+     */
+    private hideSensitiveContent;
+    /**
+     * Restore sensitive content when DevTools is closed
+     */
+    private restoreSensitiveContent;
+    /**
+     * Remove DevTools protection
+     */
+    private removeDevToolsProtection;
+    /**
+     * Apply the protection strategy
+     */
+    apply(): void;
+    /**
+     * Remove the protection strategy
+     * Override the base implementation to handle additional cleanup
+     */
+    remove(): void;
+    /**
+     * Update DevTools protection options
+     * @param options New options
+     */
+    updateOptions(options: Record<string, unknown>): void;
+    /**
+     * Set debug mode
+     * @param enabled Whether debug mode should be enabled
+     */
+    setDebugMode(enabled: boolean): void;
+}