xypriss 1.0.0 → 1.0.1

package/dist/cjs/mods/toolkit/src/components/secure-object/encryption/sensitive-keys.js

@@ -0,0 +1,206 @@
+'use strict';
+
+/**
+ * Sensitive Keys Management Module
+ * Handles the management of sensitive keys for encryption/masking
+ */
+/**
+ * Default sensitive keys that are commonly used in applications
+ */
+const DEFAULT_SENSITIVE_KEYS = [
+    // Authentication & Authorization
+    "password",
+    "passwd",
+    "pwd",
+    "secret",
+    "token",
+    "key",
+    "apikey",
+    "api_key",
+    "accesskey",
+    "access_key",
+    "accesstoken",
+    "access_token",
+    "refreshtoken",
+    "refresh_token",
+    "sessionid",
+    "session_id",
+    "auth",
+    "authorization",
+    "bearer",
+    "credential",
+    "credentials",
+    // Personal Information
+    "pin",
+    "ssn",
+    "social_security",
+    "credit_card",
+    "creditcard",
+    "cvv",
+    "cvc",
+    // Cryptographic Keys
+    "private_key",
+    "privatekey",
+    "signature",
+    "hash",
+    "salt",
+    "nonce",
+    "otp",
+    "passcode",
+    "passphrase",
+    "masterkey",
+    "master_key",
+    "encryption_key",
+    "decryption_key",
+    // Web Security
+    "jwt",
+    "cookie",
+    "session",
+    "csrf",
+    "xsrf",
+];
+/**
+ * Manages sensitive keys for a SecureObject instance
+ */
+class SensitiveKeysManager {
+    constructor(initialKeys) {
+        this.customPatterns = [];
+        this.sensitiveKeys = new Set(initialKeys || DEFAULT_SENSITIVE_KEYS);
+    }
+    /**
+     * Adds keys to the sensitive keys list
+     */
+    add(...keys) {
+        keys.forEach((key) => this.sensitiveKeys.add(key));
+        return this;
+    }
+    /**
+     * Removes keys from the sensitive keys list
+     */
+    remove(...keys) {
+        keys.forEach((key) => this.sensitiveKeys.delete(key));
+        return this;
+    }
+    /**
+     * Sets the complete list of sensitive keys (replaces existing)
+     */
+    set(keys) {
+        this.sensitiveKeys.clear();
+        keys.forEach((key) => this.sensitiveKeys.add(key));
+        return this;
+    }
+    /**
+     * Gets the current list of sensitive keys
+     */
+    getAll() {
+        return Array.from(this.sensitiveKeys);
+    }
+    /**
+     * Adds custom regex patterns for sensitive key detection
+     */
+    addCustomPatterns(...patterns) {
+        patterns.forEach((pattern) => {
+            if (typeof pattern === "string") {
+                // Convert string to case-insensitive regex
+                this.customPatterns.push(new RegExp(pattern, "i"));
+            }
+            else {
+                this.customPatterns.push(pattern);
+            }
+        });
+        return this;
+    }
+    /**
+     * Removes custom patterns
+     */
+    removeCustomPatterns(...patterns) {
+        patterns.forEach((pattern) => {
+            const patternStr = pattern.toString();
+            this.customPatterns = this.customPatterns.filter((p) => p.toString() !== patternStr);
+        });
+        return this;
+    }
+    /**
+     * Clears all custom patterns
+     */
+    clearCustomPatterns() {
+        this.customPatterns = [];
+        return this;
+    }
+    /**
+     * Gets all custom patterns
+     */
+    getCustomPatterns() {
+        return [...this.customPatterns];
+    }
+    /**
+     * Checks if a key is marked as sensitive
+     * Simple approach: exact matches + custom patterns + strict mode patterns
+     */
+    isSensitive(key, strictMode = false) {
+        const lowerKey = key.toLowerCase();
+        // 1. Check exact match first (case-insensitive) - always applies
+        if (this.sensitiveKeys.has(lowerKey)) {
+            return true;
+        }
+        // 2. Check custom patterns (user-defined patterns have priority) - always applies
+        for (const pattern of this.customPatterns) {
+            if (pattern.test(key)) {
+                // Use original case for custom patterns
+                return true;
+            }
+        }
+        // 3. In strict mode, apply additional patterns
+        if (strictMode) {
+            return this.isStrictModePattern(lowerKey);
+        }
+        // 4. In non-strict mode, only use exact matches and custom patterns
+        return false;
+    }
+    /**
+     * Simple strict mode pattern matching
+     * Only applies additional patterns when in strict mode
+     */
+    isStrictModePattern(lowerKey) {
+        // In strict mode, apply additional patterns for common sensitive key patterns
+        const strictPatterns = [
+            // Compound words ending with sensitive terms
+            /^[a-z]*password$/, // adminPassword, userPassword, etc.
+            /^[a-z]*token$/, // authToken, userToken, etc.
+            /^[a-z]*secret$/, // apiSecret, userSecret, etc.
+            /^[a-z]*key$/, // ANY word ending with "key" - be REALLY strict!
+        ];
+        // Check strict patterns
+        for (const pattern of strictPatterns) {
+            if (pattern.test(lowerKey)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Clears all sensitive keys
+     */
+    clear() {
+        this.sensitiveKeys.clear();
+        return this;
+    }
+    /**
+     * Resets to default sensitive keys
+     */
+    resetToDefault() {
+        this.sensitiveKeys.clear();
+        DEFAULT_SENSITIVE_KEYS.forEach((key) => this.sensitiveKeys.add(key));
+        return this;
+    }
+    /**
+     * Gets the default sensitive keys
+     */
+    static getDefaultKeys() {
+        return [...DEFAULT_SENSITIVE_KEYS];
+    }
+}
+
+exports.DEFAULT_SENSITIVE_KEYS = DEFAULT_SENSITIVE_KEYS;
+exports.SensitiveKeysManager = SensitiveKeysManager;
+//# sourceMappingURL=sensitive-keys.js.map

package/dist/cjs/mods/toolkit/src/components/secure-object/encryption/sensitive-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitive-keys.js","sources":["../../../../../../../../mods/toolkit/src/components/secure-object/encryption/sensitive-keys.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/cjs/mods/toolkit/src/components/secure-object/events/event-manager.js

@@ -0,0 +1,197 @@
+'use strict';
+
+/**
+ * Event Manager Module
+ * Handles event system for SecureObject
+ */
+/**
+ * Manages events for SecureObject instances
+ */
+class EventManager {
+    constructor() {
+        this.eventListeners = new Map();
+    }
+    /**
+     * Adds an event listener
+     */
+    addEventListener(event, listener) {
+        if (!this.eventListeners.has(event)) {
+            this.eventListeners.set(event, new Set());
+        }
+        this.eventListeners.get(event).add(listener);
+    }
+    /**
+     * Removes an event listener
+     */
+    removeEventListener(event, listener) {
+        const listeners = this.eventListeners.get(event);
+        if (listeners) {
+            listeners.delete(listener);
+            // Clean up empty sets
+            if (listeners.size === 0) {
+                this.eventListeners.delete(event);
+            }
+        }
+    }
+    /**
+     * Removes all listeners for a specific event
+     */
+    removeAllListeners(event) {
+        if (event) {
+            this.eventListeners.delete(event);
+        }
+        else {
+            this.eventListeners.clear();
+        }
+    }
+    /**
+     * Emits an event to all registered listeners
+     */
+    emit(event, key, value) {
+        const listeners = this.eventListeners.get(event);
+        if (listeners) {
+            for (const listener of listeners) {
+                try {
+                    listener(event, key, value);
+                }
+                catch (error) {
+                    console.error(`Error in SecureObject event listener:`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Gets the number of listeners for an event
+     */
+    getListenerCount(event) {
+        const listeners = this.eventListeners.get(event);
+        return listeners ? listeners.size : 0;
+    }
+    /**
+     * Gets all registered event types
+     */
+    getRegisteredEvents() {
+        return Array.from(this.eventListeners.keys());
+    }
+    /**
+     * Gets total number of listeners across all events
+     */
+    getTotalListenerCount() {
+        let total = 0;
+        for (const listeners of this.eventListeners.values()) {
+            total += listeners.size;
+        }
+        return total;
+    }
+    /**
+     * Checks if there are any listeners for an event
+     */
+    hasListeners(event) {
+        const listeners = this.eventListeners.get(event);
+        return listeners ? listeners.size > 0 : false;
+    }
+    /**
+     * Checks if there are any listeners at all
+     */
+    hasAnyListeners() {
+        return this.eventListeners.size > 0;
+    }
+    /**
+     * Gets a copy of all listeners for an event
+     */
+    getListeners(event) {
+        const listeners = this.eventListeners.get(event);
+        return listeners ? Array.from(listeners) : [];
+    }
+    /**
+     * Creates a one-time event listener that removes itself after first execution
+     */
+    once(event, listener) {
+        const onceListener = (evt, key, value) => {
+            this.removeEventListener(event, onceListener);
+            listener(evt, key, value);
+        };
+        this.addEventListener(event, onceListener);
+    }
+    /**
+     * Creates a promise that resolves when a specific event is emitted
+     */
+    waitFor(event, timeout) {
+        return new Promise((resolve, reject) => {
+            let timeoutId;
+            const listener = (_evt, key, value) => {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+                this.removeEventListener(event, listener);
+                resolve({ key, value });
+            };
+            this.addEventListener(event, listener);
+            if (timeout) {
+                timeoutId = setTimeout(() => {
+                    this.removeEventListener(event, listener);
+                    reject(new Error(`Event '${event}' timeout after ${timeout}ms`));
+                }, timeout);
+            }
+        });
+    }
+    /**
+     * Emits an event and waits for all listeners to complete (if they return promises)
+     */
+    async emitAsync(event, key, value) {
+        const listeners = this.eventListeners.get(event);
+        if (listeners) {
+            const promises = [];
+            for (const listener of listeners) {
+                try {
+                    const result = listener(event, key, value);
+                    if (result &&
+                        typeof result === "object" &&
+                        "then" in result) {
+                        promises.push(result);
+                    }
+                }
+                catch (error) {
+                    console.error(`Error in SecureObject event listener:`, error);
+                }
+            }
+            if (promises.length > 0) {
+                await Promise.allSettled(promises);
+            }
+        }
+    }
+    /**
+     * Creates a filtered event listener that only triggers for specific keys
+     */
+    addKeyFilteredListener(event, keys, listener) {
+        const filteredListener = (evt, key, value) => {
+            if (!key || keys.includes(key)) {
+                listener(evt, key, value);
+            }
+        };
+        this.addEventListener(event, filteredListener);
+    }
+    /**
+     * Clears all event listeners (used during destruction)
+     */
+    clear() {
+        this.eventListeners.clear();
+    }
+    /**
+     * Gets debug information about the event system
+     */
+    getDebugInfo() {
+        const eventBreakdown = {};
+        for (const [event, listeners] of this.eventListeners.entries()) {
+            eventBreakdown[event] = listeners.size;
+        }
+        return {
+            totalEvents: this.eventListeners.size,
+            totalListeners: this.getTotalListenerCount(),
+            eventBreakdown: eventBreakdown,
+        };
+    }
+}
+
+exports.EventManager = EventManager;
+//# sourceMappingURL=event-manager.js.map

package/dist/cjs/mods/toolkit/src/components/secure-object/events/event-manager.js.map

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

package/dist/cjs/mods/toolkit/src/components/secure-object/index.js

@@ -0,0 +1,67 @@
+'use strict';
+
+var secureObjectCore = require('./core/secure-object-core.js');
+require('../../core/hash/hash-core.js');
+require('../../core/hash/hash-types.js');
+require('crypto');
+require('../../core/hash/hash-security.js');
+require('../../core/hash/hash-advanced.js');
+require('../../algorithms/hash-algorithms.js');
+require('../../core/random/random-types.js');
+require('../../core/random/random-sources.js');
+require('nehonix-uri-processor');
+require('../../utils/memory/index.js');
+require('../../types.js');
+require('../../types/secure-memory.js');
+require('../secure-string/advanced/entropy-analyzer.js');
+require('../secure-string/advanced/quantum-safe.js');
+require('../secure-string/advanced/performance-monitor.js');
+require('nehoid');
+
+/***************************************************************************
+ * 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.
+ ***************************************************************************** */
+/**
+ * Main export file for SecureObject
+ */
+// Import the main SecureObject class first
+/**
+ * Factory functions for common use cases
+ */
+/**
+ * Creates a new SecureObject with default settings
+ */
+function createSecureObject(...args) {
+    return new secureObjectCore.SecureObject(...args);
+}
+
+exports.SecureObject = secureObjectCore.SecureObject;
+exports.default = secureObjectCore.SecureObject;
+exports.createSecureObject = createSecureObject;
+//# sourceMappingURL=index.js.map

package/dist/cjs/mods/toolkit/src/components/secure-object/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../../../mods/toolkit/src/components/secure-object/index.ts"],"sourcesContent":[null],"names":["SecureObject"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BiF;AAEjF;;AAEG;AAEH;AAsCA;;AAEG;AAEH;;AAEG;AACa,SAAA,kBAAkB,CAC9B,GAAG,IAAmD,EAAA;AAEtD,IAAA,OAAO,IAAIA,6BAAY,CAAI,GAAG,IAAI,CAAC,CAAC;AACxC;;;;;;"}

package/dist/cjs/mods/toolkit/src/components/secure-object/metadata/metadata-manager.js

@@ -0,0 +1,183 @@
+'use strict';
+
+/**
+ * Metadata Manager Module
+ * Handles metadata tracking for SecureObject values
+ */
+/**
+ * Manages metadata for SecureObject values
+ */
+class MetadataManager {
+    constructor() {
+        this.metadata = new Map();
+    }
+    /**
+     * Updates metadata for a key
+     */
+    update(key, type, isSecure, isAccess = false) {
+        const existing = this.metadata.get(key);
+        const now = new Date();
+        if (existing && isAccess) {
+            existing.lastAccessed = now;
+            existing.accessCount++;
+        }
+        else {
+            this.metadata.set(key, {
+                type,
+                isSecure,
+                created: existing?.created ?? now,
+                lastAccessed: now,
+                accessCount: (existing?.accessCount ?? 0) + 1,
+            });
+        }
+    }
+    /**
+     * Gets metadata for a specific key
+     */
+    get(key) {
+        return this.metadata.get(key);
+    }
+    /**
+     * Gets all metadata
+     */
+    getAll() {
+        return new Map(this.metadata);
+    }
+    /**
+     * Checks if metadata exists for a key
+     */
+    has(key) {
+        return this.metadata.has(key);
+    }
+    /**
+     * Deletes metadata for a key
+     */
+    delete(key) {
+        return this.metadata.delete(key);
+    }
+    /**
+     * Clears all metadata
+     */
+    clear() {
+        this.metadata.clear();
+    }
+    /**
+     * Gets the number of metadata entries
+     */
+    get size() {
+        return this.metadata.size;
+    }
+    /**
+     * Gets all keys that have metadata
+     */
+    keys() {
+        return Array.from(this.metadata.keys());
+    }
+    /**
+     * Gets all metadata values
+     */
+    values() {
+        return Array.from(this.metadata.values());
+    }
+    /**
+     * Gets all metadata entries as [key, metadata] pairs
+     */
+    entries() {
+        return Array.from(this.metadata.entries());
+    }
+    /**
+     * Gets statistics about the metadata
+     */
+    getStats() {
+        const entries = this.values();
+        if (entries.length === 0) {
+            return {
+                totalEntries: 0,
+                secureEntries: 0,
+                totalAccesses: 0,
+                averageAccesses: 0,
+                oldestEntry: null,
+                newestEntry: null,
+            };
+        }
+        const secureEntries = entries.filter(meta => meta.isSecure).length;
+        const totalAccesses = entries.reduce((sum, meta) => sum + meta.accessCount, 0);
+        const averageAccesses = totalAccesses / entries.length;
+        const dates = entries.map(meta => meta.created);
+        const oldestEntry = new Date(Math.min(...dates.map(d => d.getTime())));
+        const newestEntry = new Date(Math.max(...dates.map(d => d.getTime())));
+        return {
+            totalEntries: entries.length,
+            secureEntries,
+            totalAccesses,
+            averageAccesses,
+            oldestEntry,
+            newestEntry,
+        };
+    }
+    /**
+     * Filters metadata by criteria
+     */
+    filter(predicate) {
+        const filtered = new Map();
+        for (const [key, metadata] of this.metadata.entries()) {
+            if (predicate(key, metadata)) {
+                filtered.set(key, metadata);
+            }
+        }
+        return filtered;
+    }
+    /**
+     * Gets metadata for secure values only
+     */
+    getSecureMetadata() {
+        return this.filter((_, metadata) => metadata.isSecure);
+    }
+    /**
+     * Gets metadata for non-secure values only
+     */
+    getNonSecureMetadata() {
+        return this.filter((_, metadata) => !metadata.isSecure);
+    }
+    /**
+     * Gets the most accessed keys
+     */
+    getMostAccessed(limit = 10) {
+        return this.entries()
+            .sort(([, a], [, b]) => b.accessCount - a.accessCount)
+            .slice(0, limit);
+    }
+    /**
+     * Gets the least accessed keys
+     */
+    getLeastAccessed(limit = 10) {
+        return this.entries()
+            .sort(([, a], [, b]) => a.accessCount - b.accessCount)
+            .slice(0, limit);
+    }
+    /**
+     * Converts metadata to a plain object for serialization
+     */
+    toObject() {
+        return Object.fromEntries(this.metadata.entries());
+    }
+    /**
+     * Creates a MetadataManager from a plain object
+     */
+    static fromObject(obj) {
+        const manager = new MetadataManager();
+        for (const [key, metadata] of Object.entries(obj)) {
+            // Ensure dates are properly converted
+            const convertedMetadata = {
+                ...metadata,
+                created: new Date(metadata.created),
+                lastAccessed: new Date(metadata.lastAccessed),
+            };
+            manager.metadata.set(key, convertedMetadata);
+        }
+        return manager;
+    }
+}
+
+exports.MetadataManager = MetadataManager;
+//# sourceMappingURL=metadata-manager.js.map

package/dist/cjs/mods/toolkit/src/components/secure-object/metadata/metadata-manager.js.map

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