content-security-toolkit 1.0.0

package/dist/utils/timeoutManager.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Manages timeouts for the content protection toolkit
+ * Provides a centralized way to create, track, and clear timeouts
+ */
+export declare class TimeoutManager {
+    private static instance;
+    private timeouts;
+    private logger;
+    /**
+     * Create a new TimeoutManager
+     * @param debugMode Enable debug mode for troubleshooting
+     */
+    private constructor();
+    /**
+     * Get the TimeoutManager instance (singleton)
+     * @param debugMode Enable debug mode for troubleshooting
+     */
+    static getInstance(debugMode?: boolean): TimeoutManager;
+    /**
+     * Set a timeout with a unique ID
+     * @param id Unique identifier for the timeout
+     * @param callback Function to execute
+     * @param delay Delay in milliseconds
+     * @returns The timeout ID for later reference
+     */
+    setTimeout(id: string, callback: () => void, delay: number): string;
+    /**
+     * Clear a timeout by ID
+     * @param id Timeout ID to clear
+     * @returns True if the timeout was found and cleared
+     */
+    clearTimeout(id: string): boolean;
+    /**
+     * Clear all timeouts
+     * @returns Number of timeouts cleared
+     */
+    clearAllTimeouts(): number;
+    /**
+     * Check if a timeout exists
+     * @param id Timeout ID to check
+     * @returns True if the timeout exists
+     */
+    hasTimeout(id: string): boolean;
+    /**
+     * Get the number of active timeouts
+     * @returns Number of active timeouts
+     */
+    getTimeoutCount(): number;
+    /**
+     * Set debug mode
+     * @param enabled Whether debug mode should be enabled
+     */
+    setDebugMode(enabled: boolean): void;
+}
+export declare const timeoutManager: TimeoutManager;

package/dist/utils/timeoutManager.js

@@ -0,0 +1,121 @@
+import { isBrowser } from "./environment";
+import { SimpleLoggingService } from "./logging/simple/SimpleLoggingService";
+/**
+ * Manages timeouts for the content protection toolkit
+ * Provides a centralized way to create, track, and clear timeouts
+ */
+export class TimeoutManager {
+    /**
+     * Create a new TimeoutManager
+     * @param debugMode Enable debug mode for troubleshooting
+     */
+    constructor(debugMode = false) {
+        this.timeouts = new Map();
+        this.logger = new SimpleLoggingService("TimeoutManager", debugMode);
+        this.logger.log("Initialized");
+    }
+    /**
+     * Get the TimeoutManager instance (singleton)
+     * @param debugMode Enable debug mode for troubleshooting
+     */
+    static getInstance(debugMode = false) {
+        if (!TimeoutManager.instance) {
+            TimeoutManager.instance = new TimeoutManager(debugMode);
+        }
+        // Update debug mode if it's explicitly passed
+        if (arguments.length > 0) {
+            TimeoutManager.instance.setDebugMode(debugMode);
+        }
+        return TimeoutManager.instance;
+    }
+    /**
+     * Set a timeout with a unique ID
+     * @param id Unique identifier for the timeout
+     * @param callback Function to execute
+     * @param delay Delay in milliseconds
+     * @returns The timeout ID for later reference
+     */
+    setTimeout(id, callback, delay) {
+        if (!isBrowser())
+            return id;
+        // Clear any existing timeout with this ID
+        this.clearTimeout(id);
+        // Create a new timeout
+        const timeoutId = window.setTimeout(() => {
+            // Remove from our map when it executes
+            this.timeouts.delete(id);
+            // Execute the callback
+            try {
+                callback();
+            }
+            catch (error) {
+                this.logger.error(`Error executing timeout "${id}":`, error);
+            }
+        }, delay);
+        // Store in our map
+        this.timeouts.set(id, timeoutId);
+        this.logger.log(`Set timeout "${id}" with delay ${delay}ms`);
+        return id;
+    }
+    /**
+     * Clear a timeout by ID
+     * @param id Timeout ID to clear
+     * @returns True if the timeout was found and cleared
+     */
+    clearTimeout(id) {
+        if (!isBrowser())
+            return false;
+        const timeoutId = this.timeouts.get(id);
+        if (timeoutId !== undefined) {
+            window.clearTimeout(timeoutId);
+            this.timeouts.delete(id);
+            this.logger.log(`Cleared timeout "${id}"`);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Clear all timeouts
+     * @returns Number of timeouts cleared
+     */
+    clearAllTimeouts() {
+        if (!isBrowser())
+            return 0;
+        let count = 0;
+        this.timeouts.forEach((timeoutId, _id) => {
+            window.clearTimeout(timeoutId);
+            count++;
+        });
+        this.timeouts.clear();
+        if (count > 0) {
+            this.logger.log(`Cleared all ${count} timeouts`);
+        }
+        return count;
+    }
+    /**
+     * Check if a timeout exists
+     * @param id Timeout ID to check
+     * @returns True if the timeout exists
+     */
+    hasTimeout(id) {
+        return this.timeouts.has(id);
+    }
+    /**
+     * Get the number of active timeouts
+     * @returns Number of active timeouts
+     */
+    getTimeoutCount() {
+        return this.timeouts.size;
+    }
+    /**
+     * Set debug mode
+     * @param enabled Whether debug mode should be enabled
+     */
+    setDebugMode(enabled) {
+        this.logger.setDebugMode(enabled);
+        this.logger.log(`Debug mode ${enabled ? "enabled" : "disabled"}`);
+    }
+}
+TimeoutManager.instance = null;
+// Create a singleton instance for use throughout the application
+export const timeoutManager = TimeoutManager.getInstance(false);

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "content-security-toolkit",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "lint": "eslint 'src/**/*.ts'",
+    "format": "prettier --write 'src/**/*.ts'",
+    "prepublishOnly": "npm run lint && npm run test && npm run build",
+    "prepare": "npm run build",
+    "examples:install": "cd examples && npm install",
+    "examples:build": "npm run build && npm run examples:install",
+    "examples:start": "cd examples && npm run start"
+  },
+  "keywords": [
+    "security",
+    "content-protection",
+    "drm",
+    "web-security"
+  ],
+  "author": "Iker Laforga",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Isonimus/content-security-toolkit.git"
+  },
+  "description": "Lightweight TypeScript toolkit to protect web content: blocks copying/printing, detects devtools/screenshots, adds watermarks, and provides extensible strategies and detectors.",
+  "devDependencies": {
+    "@eslint/js": "^9.22.0",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.13.10",
+    "eslint": "^9.22.0",
+    "eslint-config-prettier": "^10.1.1",
+    "jest": "^29.7.0",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.2.6",
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.27.0"
+  },
+  "eslintConfig": {
+    "files": [
+      "eslint.config.js"
+    ]
+  },
+  "dependencies": {
+    "jest-environment-jsdom": "^29.7.0"
+  }
+}