@tindalabs/shield 0.1.0

package/dist/utils/timeoutManager.d.ts

@@ -0,0 +1,50 @@
+import { LoggableComponent } from "./base/LoggableComponent";
+/**
+ * Manages timeouts for the content protection toolkit
+ * Provides a centralized way to create, track, and clear timeouts
+ */
+export declare class TimeoutManager extends LoggableComponent {
+    private static instance;
+    private timeouts;
+    /**
+     * 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;
+}
+export declare const timeoutManager: TimeoutManager;

package/dist/utils/timeoutManager.js

@@ -0,0 +1,113 @@
+import { isBrowser } from "./environment";
+import { LoggableComponent } from "./base/LoggableComponent";
+/**
+ * Manages timeouts for the content protection toolkit
+ * Provides a centralized way to create, track, and clear timeouts
+ */
+export class TimeoutManager extends LoggableComponent {
+    /**
+     * Create a new TimeoutManager
+     * @param debugMode Enable debug mode for troubleshooting
+     */
+    constructor(debugMode = false) {
+        super("TimeoutManager", debugMode);
+        this.timeouts = new Map();
+        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;
+    }
+}
+TimeoutManager.instance = null;
+// Create a singleton instance for use throughout the application
+export const timeoutManager = TimeoutManager.getInstance(false);

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@tindalabs/shield",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "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": [
+    "browser-security",
+    "tamper-detection",
+    "devtools-detection",
+    "automation-detection",
+    "webdriver",
+    "headless",
+    "content-protection",
+    "fingerprinting",
+    "opentelemetry",
+    "typescript",
+    "frontend-security"
+  ],
+  "author": "Isonimus",
+  "license": "MIT",
+  "homepage": "https://github.com/tindalabs/shield#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tindalabs/shield.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tindalabs/shield/issues"
+  },
+  "description": "Browser tamper detection for hostile environments. Detects DevTools, automation drivers, extension injection, and environment spoofing — surfaces findings as structured risk signals, not just boolean flags.",
+  "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",
+    "jest-environment-jsdom": "^29.7.0",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.2.6",
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.27.0"
+  }
+}