xypriss 1.0.0 → 1.1.0

package/dist/esm/mods/toolkit/src/utils/memory/event-manager.js

@@ -0,0 +1,275 @@
+import { MemoryEventType } from './types.js';
+
+/**
+ * Memory Event Manager
+ *
+ * Handles all memory-related events with filtering, history, and error handling
+ */
+/**
+ * Event manager for memory events with advanced features
+ */
+class MemoryEventManager {
+    constructor(config) {
+        this.listeners = new Map();
+        this.eventHistory = [];
+        this.filters = new Set();
+        this.isEnabled = true;
+        this.eventCounts = new Map();
+        this.maxHistorySize = config.maxEventHistory;
+    }
+    /**
+     * Add event listener
+     */
+    on(type, listener) {
+        if (!this.listeners.has(type)) {
+            this.listeners.set(type, new Set());
+        }
+        this.listeners.get(type).add(listener);
+    }
+    /**
+     * Add event listener for multiple types
+     */
+    onMultiple(types, listener) {
+        types.forEach(type => this.on(type, listener));
+    }
+    /**
+     * Add one-time event listener
+     */
+    once(type, listener) {
+        const onceWrapper = (event) => {
+            listener(event);
+            this.off(type, onceWrapper);
+        };
+        this.on(type, onceWrapper);
+    }
+    /**
+     * Remove event listener
+     */
+    off(type, listener) {
+        const listeners = this.listeners.get(type);
+        if (listeners) {
+            listeners.delete(listener);
+            if (listeners.size === 0) {
+                this.listeners.delete(type);
+            }
+        }
+    }
+    /**
+     * Remove all listeners for a type
+     */
+    removeAllListeners(type) {
+        if (type) {
+            this.listeners.delete(type);
+        }
+        else {
+            this.listeners.clear();
+        }
+    }
+    /**
+     * Add event filter
+     */
+    addFilter(filter) {
+        this.filters.add(filter);
+    }
+    /**
+     * Remove event filter
+     */
+    removeFilter(filter) {
+        this.filters.delete(filter);
+    }
+    /**
+     * Clear all filters
+     */
+    clearFilters() {
+        this.filters.clear();
+    }
+    /**
+     * Enable/disable event manager
+     */
+    setEnabled(enabled) {
+        this.isEnabled = enabled;
+    }
+    /**
+     * Check if event passes all filters
+     */
+    passesFilters(event) {
+        for (const filter of this.filters) {
+            try {
+                if (!filter(event)) {
+                    return false;
+                }
+            }
+            catch (error) {
+                console.error('Error in event filter:', error);
+                // Continue with other filters
+            }
+        }
+        return true;
+    }
+    /**
+     * Emit event with comprehensive error handling
+     */
+    emit(type, data, metadata) {
+        if (!this.isEnabled) {
+            return;
+        }
+        const event = {
+            type,
+            timestamp: Date.now(),
+            data,
+            metadata: {
+                ...metadata,
+                eventId: this.generateEventId(),
+                sequence: this.getEventCount(type)
+            }
+        };
+        // Apply filters
+        if (!this.passesFilters(event)) {
+            return;
+        }
+        // Update event count
+        this.eventCounts.set(type, (this.eventCounts.get(type) || 0) + 1);
+        // Add to history
+        this.addToHistory(event);
+        // Notify listeners
+        this.notifyListeners(type, event);
+    }
+    /**
+     * Add event to history with size management
+     */
+    addToHistory(event) {
+        this.eventHistory.push(event);
+        // Maintain history size
+        while (this.eventHistory.length > this.maxHistorySize) {
+            this.eventHistory.shift();
+        }
+    }
+    /**
+     * Notify all listeners for an event type
+     */
+    notifyListeners(type, event) {
+        const listeners = this.listeners.get(type);
+        if (!listeners || listeners.size === 0) {
+            return;
+        }
+        // Create array to avoid modification during iteration
+        const listenerArray = Array.from(listeners);
+        for (const listener of listenerArray) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error(`Error in memory event listener for ${type}:`, error);
+                // Emit error event (but avoid infinite loops)
+                if (type !== MemoryEventType.ERROR_OCCURRED) {
+                    this.emit(MemoryEventType.ERROR_OCCURRED, {
+                        originalEvent: event,
+                        error: error instanceof Error ? error.message : String(error),
+                        listenerError: true
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Generate unique event ID
+     */
+    generateEventId() {
+        return `evt_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Get event count for a type
+     */
+    getEventCount(type) {
+        return this.eventCounts.get(type) || 0;
+    }
+    /**
+     * Get event history with optional filtering
+     */
+    getHistory(type, limit) {
+        let events = type
+            ? this.eventHistory.filter(event => event.type === type)
+            : [...this.eventHistory];
+        if (limit && limit > 0) {
+            events = events.slice(-limit);
+        }
+        return events;
+    }
+    /**
+     * Get event statistics
+     */
+    getEventStats() {
+        const stats = {
+            totalEvents: this.eventHistory.length,
+            eventCounts: Object.fromEntries(this.eventCounts),
+            activeListeners: this.listeners.size,
+            activeFilters: this.filters.size,
+            isEnabled: this.isEnabled,
+            historySize: this.eventHistory.length,
+            maxHistorySize: this.maxHistorySize
+        };
+        // Calculate event frequency (events per minute)
+        if (this.eventHistory.length > 1) {
+            const firstEvent = this.eventHistory[0];
+            const lastEvent = this.eventHistory[this.eventHistory.length - 1];
+            const timeSpan = lastEvent.timestamp - firstEvent.timestamp;
+            stats.eventsPerMinute = (this.eventHistory.length / timeSpan) * 60000;
+        }
+        return stats;
+    }
+    /**
+     * Clear event history
+     */
+    clearHistory() {
+        this.eventHistory = [];
+    }
+    /**
+     * Clear event counts
+     */
+    clearEventCounts() {
+        this.eventCounts.clear();
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        if (config.maxEventHistory !== undefined) {
+            this.maxHistorySize = config.maxEventHistory;
+            // Trim history if needed
+            while (this.eventHistory.length > this.maxHistorySize) {
+                this.eventHistory.shift();
+            }
+        }
+    }
+    /**
+     * Get listener count for a specific event type
+     */
+    getListenerCount(type) {
+        return this.listeners.get(type)?.size || 0;
+    }
+    /**
+     * Check if there are any listeners for an event type
+     */
+    hasListeners(type) {
+        return this.getListenerCount(type) > 0;
+    }
+    /**
+     * Get all registered event types
+     */
+    getRegisteredEventTypes() {
+        return Array.from(this.listeners.keys());
+    }
+    /**
+     * Destroy the event manager
+     */
+    destroy() {
+        this.listeners.clear();
+        this.eventHistory = [];
+        this.filters.clear();
+        this.eventCounts.clear();
+        this.isEnabled = false;
+    }
+}
+
+export { MemoryEventManager };
+//# sourceMappingURL=event-manager.js.map

package/dist/esm/mods/toolkit/src/utils/memory/event-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-manager.js","sources":["../../../../../../../mods/toolkit/src/utils/memory/event-manager.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/mods/toolkit/src/utils/memory/index.js

@@ -0,0 +1,141 @@
+export { MemoryErrorType, MemoryEventType, MemoryPressureLevel, PoolStrategy } from './types.js';
+export { AdvancedReferenceTracker } from './reference-tracker.js';
+import { AdvancedMemoryManager } from './memory-manager.js';
+
+/***************************************************************************
+ * XyPrissSecurity - Secure Array Types
+ *
+ * This file contains type definitions for the SecureArray modular architecture
+ *
+ * @author Nehonix
+ *
+ * @license MIT
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ ***************************************************************************** */
+/**
+ * Memory Management Module for XyPrissSecurity
+ *
+ * This module provides advanced memory management capabilities including:
+ * - Object reference tracking with leak detection
+ * - Configurable memory pools with multiple strategies
+ * - Event-driven memory monitoring
+ * - Cross-platform compatibility (Node.js & Browser)
+ * - Comprehensive performance metrics
+ */
+// Export all types
+/**
+ * Global memory manager instance
+ *
+ * This is the main entry point for memory management in XyPrissSecurity.
+ * It provides a singleton instance that can be used throughout the application.
+ */
+const memoryManager = AdvancedMemoryManager.getInstance();
+/**
+ * Utility functions for memory management
+ */
+const MemoryUtils = {
+    /**
+     * Format bytes to human-readable string
+     */
+    formatBytes(bytes) {
+        const units = ["B", "KB", "MB", "GB"];
+        let size = bytes;
+        let unitIndex = 0;
+        while (size >= 1024 && unitIndex < units.length - 1) {
+            size /= 1024;
+            unitIndex++;
+        }
+        return `${size.toFixed(2)} ${units[unitIndex]}`;
+    },
+    /**
+     * Format duration to human-readable string
+     */
+    formatDuration(ms) {
+        const seconds = Math.floor(ms / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        const days = Math.floor(hours / 24);
+        if (days > 0)
+            return `${days}d ${hours % 24}h ${minutes % 60}m`;
+        if (hours > 0)
+            return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
+        if (minutes > 0)
+            return `${minutes}m ${seconds % 60}s`;
+        return `${seconds}s`;
+    },
+    /**
+     * Estimate object size in bytes
+     */
+    estimateObjectSize(obj) {
+        if (obj === null || obj === undefined)
+            return 0;
+        const type = typeof obj;
+        switch (type) {
+            case "boolean":
+                return 4;
+            case "number":
+                return 8;
+            case "string":
+                return obj.length * 2; // UTF-16
+            case "object":
+                if (obj instanceof ArrayBuffer)
+                    return obj.byteLength;
+                if (obj instanceof Uint8Array)
+                    return obj.byteLength;
+                if (Array.isArray(obj)) {
+                    return obj.reduce((sum, item) => sum + MemoryUtils.estimateObjectSize(item), 0);
+                }
+                return Object.keys(obj).length * 64; // Rough estimate
+            default:
+                return 64; // Default estimate
+        }
+    },
+    /**
+     * Check if current environment supports advanced memory features
+     */
+    supportsAdvancedFeatures() {
+        return (typeof WeakRef !== "undefined" &&
+            typeof FinalizationRegistry !== "undefined");
+    },
+    /**
+     * Get current memory usage (Node.js only)
+     */
+    getCurrentMemoryUsage() {
+        if (typeof process !== "undefined" && process.memoryUsage) {
+            return process.memoryUsage();
+        }
+        return null;
+    },
+    /**
+     * Force garbage collection if available
+     */
+    forceGC() {
+        if (typeof global !== "undefined" && global.gc) {
+            global.gc();
+            return true;
+        }
+        return false;
+    },
+};
+
+export { AdvancedMemoryManager, MemoryUtils, memoryManager };
+//# sourceMappingURL=index.js.map

package/dist/esm/mods/toolkit/src/utils/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../../../mods/toolkit/src/utils/memory/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}