xypriss 1.0.1 → 1.1.0

package/README.md

@@ -4,76 +4,79 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**XyPriss** is a high-performance, security-focused Node.js framework that enhances Express.js with enterprise-grade features. Built with TypeScript and featuring a modular architecture, XyPriss provides developers with a fast, secure way to create scalable web applications while maintaining full Express.js compatibility.
+XyPriss is a Node.js framework that extends Express.js with additional performance, security, and scalability features. Built with TypeScript, it maintains full Express.js compatibility while adding enterprise-level capabilities for production applications.
 
-## 🚀 Key Features
+> **Migration Notice**: This library is the separated version of FortifyJS accessible via [the link](https://github.com/nehonix/FortifyJS) or using `npm install fortify2-js`. The FortifyJS library will be deprecated soon, so start moving from it to XyPriss for future improvements.
 
-### Performance & Scalability
+## Key Features
 
--   **Ultra-Fast Request Processing**: Advanced request pre-compilation and optimization
--   **Intelligent Caching**: Multi-tier caching with Redis, Memory, and File system support
--   **Cluster Management**: Built-in clustering with auto-scaling capabilities
--   **Smart Routing**: Dynamic route optimization and intelligent request handling
+### Performance and Scalability
 
-### Security First
+-   Fast server initialization with minimal overhead
+-   Multi-tier caching system supporting memory, Redis, and hybrid strategies
+-   Automatic port detection and switching with configurable port ranges
+-   Built-in clustering with automatic scaling based on system load
+-   Advanced request management including timeouts and concurrency controls
 
--   **XyPriss Security Module**: Comprehensive cryptographic utilities and secure data handling
--   **Fortified Functions**: Tamper-resistant function execution with integrity verification
--   **Advanced Middleware**: Built-in protection against XSS, SQL injection, and other attacks
--   **Secure Memory Management**: Protected memory allocation and cleanup
+### Security and Reliability
+
+-   Integration with XyPriss Security module for cryptographic operations
+-   Built-in security middleware including Helmet, CORS, rate limiting, and CSRF protection
+-   Tamper-evident logging with cryptographic verification
+-   Input validation and sanitization utilities
 
 ### Developer Experience
 
--   **TypeScript Native**: Full TypeScript support with comprehensive type definitions
--   **Modular Architecture**: Plugin-based system for extensibility
--   **Rich Ecosystem**: Integration with XyPriss Security toolkit
--   **Comprehensive Documentation**: Detailed guides and API references
+-   Full compatibility with existing Express.js applications
+-   Complete TypeScript support with type definitions
+-   Extensible plugin system for custom functionality
+-   Comprehensive documentation and examples
 
-## 📦 Installation
+## Installation
 
 ```bash
 npm install xypriss
 npm i --save-dev @types/express
 ```
 
-For the complete security toolkit:
+For security features:
 
 ```bash
 npm install xypriss xypriss-security
 npm i --save-dev @types/express
 ```
 
-## 🏃‍♂️ Quick Start
+## Quick Start
 
 ### Basic Server Setup
 
 ```typescript
 import { createServer } from "xypriss";
 
-// Create a new XyPriss server (enhanced ExpressJS)
+// Create a new XyPriss server
 const server = createServer({
-    port: 3000,
-    security: {
-        enabled: true,
-        rateLimit: {
-            windowMs: 15 * 60 * 1000, // 15 minutes
-            max: 100, // limit each IP to 100 requests per windowMs
+    server: {
+        port: 3000,
+        host: "localhost",
+        autoPortSwitch: {
+            enabled: true,
+            portRange: [8086, 3010],
         },
     },
     cache: {
-        type: "memory",
-        maxSize: 100, // 100MB
+        strategy: "memory",
+        maxSize: 100 * 1024 * 1024, // 100MB
+        ttl: 3600, // 1 hour
     },
 });
 
-// Define routes (ExpressJS-compatible)
+// Define routes using standard Express.js syntax
 server.get("/", (req, res) => {
     res.json({ message: "Hello from XyPriss!" });
 });
 
 server.get("/api/users/:id", (req, res) => {
     const userId = req.params.id;
-    // Your logic here
     res.json({ userId, data: "User data" });
 });
 
@@ -83,22 +86,79 @@ server.listen(3000, () => {
 });
 ```
 
-### XyPriss Security Integration
+### Advanced Configuration
+
+```typescript
+import { createServer } from "xypriss";
 
-XyPriss seamlessly integrates with the XyPriss Security toolkit, providing:
+const server = createServer({
+    env: "production",
+
+    server: {
+        port: 8080,
+        host: "0.0.0.0",
+        autoPortSwitch: {
+            enabled: true,
+            maxAttempts: 5,
+            portRange: [8080, 8090],
+            strategy: "increment",
+        },
+    },
 
--   Advanced cryptographic functions
--   Secure data structures
--   Tamper-evident logging
--   Fortified function execution
+    cache: {
+        strategy: "hybrid", // Memory + Redis
+        maxSize: 500 * 1024 * 1024, // 500MB
+        ttl: 7200, // 2 hours
+        redis: {
+            host: "localhost",
+            port: 6379,
+            cluster: true,
+            nodes: [
+                { host: "redis-1", port: 6379 },
+                { host: "redis-2", port: 6379 },
+            ],
+        },
+    },
+
+    requestManagement: {
+        timeout: {
+            enabled: true,
+            defaultTimeout: 30000, // 30 seconds
+            routes: {
+                "/api/upload": 300000, // 5 minutes for uploads
+                "/api/quick": 5000, // 5 seconds for quick endpoints
+            },
+        },
+        concurrency: {
+            maxConcurrentRequests: 1000,
+            maxPerIP: 50,
+        },
+    },
+
+    cluster: {
+        enabled: true,
+        workers: "auto", // Auto-detect CPU cores
+        autoScale: {
+            enabled: true,
+            minWorkers: 2,
+            maxWorkers: 8,
+            cpuThreshold: 80,
+        },
+    },
+});
+```
+
+### With XyPriss Security Integration
 
 ```typescript
 import { createServer } from "xypriss";
-import { XyPrissSecurity, SecureString, Hash } from "xypriss-security";
+import { XyPrissSecurity, fString, fArray } from "xypriss-security";
 
 const server = createServer({
-    port: 3000,
-    security: { enabled: true },
+    server: {
+        port: 3000,
+        host: "localhost",
+    },
 });
 
 // Initialize security module
@@ -107,15 +167,23 @@ const security = new XyPrissSecurity();
 // Secure route with encryption
 server.post("/api/secure-data", async (req, res) => {
     try {
-        // Encrypt sensitive data
-        const encryptedData = await security.encrypt(req.body.data);
+        // Use secure data structures
+        const secureData = fArray(req.body.sensitiveArray);
+        const securePassword = fString(req.body.password, {
+            protectionLevel: "maximum",
+            enableEncryption: true,
+        });
 
-        // Store securely (example)
-        const secureStorage = new SecureString(encryptedData);
+        // Generate secure token
+        const token = security.generateSecureToken({
+            length: 32,
+            entropy: "maximum",
+        });
 
         res.json({
             success: true,
-            hash: Hash.create(req.body.data, { algorithm: "sha256" }),
+            token,
+            dataLength: secureData.length,
         });
     } catch (error) {
         res.status(500).json({ error: "Security operation failed" });
@@ -127,66 +195,101 @@ server.listen(3000, () => {
 });
 ```
 
-## 📚 Documentation
+## Architecture
+
+XyPriss uses a modular architecture with the following core components:
+
+### Core Framework (`xypriss`)
+
+-   Server Factory: Enhanced Express.js server creation with `createServer()`
+-   Cache Engine: Multi-tier caching system with intelligent invalidation
+-   Cluster Manager: Process management and auto-scaling
+-   Plugin System: Extensible plugin architecture
+-   Request Management: Advanced timeout and concurrency controls
+
+### Security Module (`xypriss-security`)
+
+XyPriss integrates with the XyPriss Security toolkit, providing:
+
+-   Secure Data Structures: `fArray`, `fString`, `fObject` with encryption
+-   Cryptographic Functions: Token generation, hashing, key derivation
+-   Advanced Security: Post-quantum cryptography, tamper-evident logging
+-   Performance: Fortified functions with security monitoring
+
+```typescript
+import { createServer } from "xypriss";
+import {
+    XyPrissSecurity,
+    fArray,
+    fString,
+    fObject,
+    generateSecureToken,
+} from "xypriss-security";
+
+// Use both together
+const server = createServer({
+    /* config */
+});
+const security = new XyPrissSecurity();
+```
+
+## Documentation
 
 -   [Getting Started Guide](./docs/getting-started.md)
 -   [API Reference](./docs/api-reference.md)
 -   [Security Guide](./docs/security.md)
--   [Performance Optimization](./docs/performance.md)
+-   [Configuration Options](./docs/configuration.md)
 -   [Plugin Development](./docs/plugins.md)
--   [Deployment Guide](./docs/deployment.md)
 
-## 🔧 Configuration
+## Configuration
 
-XyPriss supports extensive configuration options:
+XyPriss supports extensive configuration through the `ServerOptions` interface:
 
 ```typescript
-interface XyPrissConfig {
-    server?: ServerConfig;
-    security?: SecurityConfig;
-    cache?: CacheConfig;
+interface ServerOptions {
+    env?: "development" | "production" | "test";
+    server?: {
+        port?: number;
+        host?: string;
+        autoPortSwitch?: {
+            enabled?: boolean;
+            portRange?: [number, number];
+            strategy?: "increment" | "random" | "predefined";
+        };
+    };
+    cache?: {
+        strategy?: "auto" | "memory" | "redis" | "hybrid";
+        maxSize?: number;
+        ttl?: number;
+        redis?: RedisConfig;
+    };
+    requestManagement?: RequestManagementConfig;
     cluster?: ClusterConfig;
-    performance?: PerformanceConfig;
-    plugins?: PluginConfig[];
+    // ... and many more options
 }
 ```
 
-See the [Configuration Guide](./docs/configuration.md) for detailed options.
-
-## 🚀 Performance
+## Performance
 
-XyPriss is designed for high performance:
+XyPriss is optimized for production use:
 
--   **Request Processing**: Up to 50,000+ requests/second
--   **Memory Efficiency**: Optimized memory usage with automatic cleanup
--   **CPU Utilization**: Intelligent load balancing across CPU cores
--   **Caching**: Sub-millisecond cache retrieval times
+-   Fast server initialization with minimal overhead
+-   High-throughput request handling
+-   Efficient memory usage with automatic cleanup
+-   Low-latency cache access
+-   Horizontal scaling through clustering
 
-## 🔒 Security
+## Contributing
 
-Security is built into every aspect of XyPriss:
+Contributions are welcome. Please see our [Contributing Guide](./CONTRIBUTING.md).
 
--   **Input Validation**: Automatic sanitization and validation
--   **Output Encoding**: XSS protection through secure encoding
--   **SQL Injection Protection**: Parameterized query enforcement
--   **Rate Limiting**: Configurable rate limiting per IP/user
--   **Secure Headers**: Automatic security header injection
+## License
 
-## 🤝 Contributing
+MIT License - see [LICENSE](./LICENSE) file for details.
 
-We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
-
-## 📄 License
-
-This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
-
-## 🆘 Support
+## Support
 
 -   [Documentation](./docs/)
--   [GitHub Issues](https://github.com/your-org/xypriss/issues)
--   [Discord Community](https://discord.gg/xypriss)
-
----
-
-**XyPriss** - Ultra-fast, secure, and scalable Node.js framework for modern web applications.
+-   [GitHub Issues](https://github.com/Nehonix-Team/XyPriss/issues)
+-   [Security Advisories](https://github.com/Nehonix-Team/XyPriss/security)
 

package/dist/cjs/ServerFactory.js

@@ -4,7 +4,7 @@ var express = require('express');
 var helmet = require('helmet');
 var cors = require('cors');
 var compression = require('compression');
-var safeSerializer = require('./mods/toolkit/src/components/fortified-function/serializer/safe-serializer.js');
+var safeSerializer = require('./mods/security/src/components/fortified-function/serializer/safe-serializer.js');
 require('./server/utils/Logger.js');
 var FastServer = require('./server/FastServer.js');
 

package/dist/cjs/cache/SecureCacheAdapter.js

@@ -2,9 +2,9 @@
 
 var events = require('events');
 var Redis = require('ioredis');
-var useCache = require('../mods/toolkit/src/components/cache/useCache.js');
+var useCache = require('../mods/security/src/components/cache/useCache.js');
 var EncryptionService = require('../encryption/EncryptionService.js');
-var crypto = require('../mods/toolkit/src/core/crypto.js');
+var crypto = require('../mods/security/src/core/crypto.js');
 var Logger = require('../server/utils/Logger.js');
 
 /**

package/dist/cjs/cluster/cluster-manager.js

@@ -9,7 +9,7 @@ var IPCManager = require('./modules/IPCManager.js');
 var MetricsCollector = require('./modules/MetricsCollector.js');
 var AutoScaler = require('./modules/AutoScaler.js');
 var ClusterPersistenceManager = require('./modules/ClusterPersistenceManager.js');
-var errorHandler = require('../mods/toolkit/src/utils/errorHandler.js');
+var errorHandler = require('../mods/security/src/utils/errorHandler.js');
 var Cluster_config = require('../server/const/Cluster.config.js');
 var Logger = require('../server/utils/Logger.js');
 

package/dist/cjs/cluster/index.js

@@ -5,40 +5,40 @@ require('os');
 require('events');
 require('cluster');
 require('pidusage');
-require('../mods/toolkit/src/utils/errorHandler.js');
-require('../mods/toolkit/src/components/fortified-function/core/fortified-function-core.js');
-require('../mods/toolkit/src/components/fortified-function/core/fortified-config.js');
-require('../mods/toolkit/src/components/fortified-function/core/fortified-logger.js');
-require('../mods/toolkit/src/components/fortified-function/serializer/safe-serializer.js');
+require('../mods/security/src/utils/errorHandler.js');
+require('../mods/security/src/components/fortified-function/core/fortified-function-core.js');
+require('../mods/security/src/components/fortified-function/core/fortified-config.js');
+require('../mods/security/src/components/fortified-function/core/fortified-logger.js');
+require('../mods/security/src/components/fortified-function/serializer/safe-serializer.js');
 require('nehoid');
-require('../mods/toolkit/src/utils/memory/index.js');
+require('../mods/security/src/utils/memory/index.js');
 require('crypto');
-require('../mods/toolkit/src/types/secure-memory.js');
-require('../mods/toolkit/src/components/secure-string/advanced/entropy-analyzer.js');
-require('../mods/toolkit/src/components/secure-string/advanced/quantum-safe.js');
-require('../mods/toolkit/src/components/secure-string/advanced/performance-monitor.js');
-require('../mods/toolkit/src/core/hash/hash-core.js');
-require('../mods/toolkit/src/core/hash/hash-types.js');
-require('../mods/toolkit/src/core/hash/hash-security.js');
-require('../mods/toolkit/src/core/hash/hash-advanced.js');
-require('../mods/toolkit/src/algorithms/hash-algorithms.js');
-require('../mods/toolkit/src/core/random/random-types.js');
-require('../mods/toolkit/src/core/random/random-sources.js');
+require('../mods/security/src/types/secure-memory.js');
+require('../mods/security/src/components/secure-string/advanced/entropy-analyzer.js');
+require('../mods/security/src/components/secure-string/advanced/quantum-safe.js');
+require('../mods/security/src/components/secure-string/advanced/performance-monitor.js');
+require('../mods/security/src/core/hash/hash-core.js');
+require('../mods/security/src/core/hash/hash-types.js');
+require('../mods/security/src/core/hash/hash-security.js');
+require('../mods/security/src/core/hash/hash-advanced.js');
+require('../mods/security/src/algorithms/hash-algorithms.js');
+require('../mods/security/src/core/random/random-types.js');
+require('../mods/security/src/core/random/random-sources.js');
 require('nehonix-uri-processor');
-require('../mods/toolkit/src/types.js');
-require('../mods/toolkit/src/components/secure-array/utils/id-generator.js');
-require('../mods/toolkit/src/index.js');
+require('../mods/security/src/types.js');
+require('../mods/security/src/components/secure-array/utils/id-generator.js');
+require('../mods/security/src/index.js');
 require('argon2');
 require('child_process');
 require('https');
-require('../mods/toolkit/src/components/runtime-verification.js');
-require('../mods/toolkit/src/components/tamper-evident-logging.js');
-require('../mods/toolkit/src/core/keys/keys-types.js');
-require('../mods/toolkit/src/core/keys/keys-logger.js');
-require('../mods/toolkit/src/core/keys/keys-utils.js');
-require('../mods/toolkit/src/core/keys/algorithms/mods/PBKDF2Algo.js');
-require('../mods/toolkit/src/core/password/index.js');
-require('../mods/toolkit/src/components/fortified-function/UFA/ultra-fast-allocator.js');
+require('../mods/security/src/components/runtime-verification.js');
+require('../mods/security/src/components/tamper-evident-logging.js');
+require('../mods/security/src/core/keys/keys-types.js');
+require('../mods/security/src/core/keys/keys-logger.js');
+require('../mods/security/src/core/keys/keys-utils.js');
+require('../mods/security/src/core/keys/algorithms/mods/PBKDF2Algo.js');
+require('../mods/security/src/core/password/index.js');
+require('../mods/security/src/components/fortified-function/UFA/ultra-fast-allocator.js');
 require('../server/utils/Logger.js');
 require('http');
 require('msgpack-lite');
@@ -46,8 +46,8 @@ require('fast-json-stable-stringify');
 require('perf_hooks');
 require('fs');
 require('path');
-require('../mods/toolkit/src/components/cache/cacheSys.js');
-require('../mods/toolkit/src/components/cache/index.js');
+require('../mods/security/src/components/cache/cacheSys.js');
+require('../mods/security/src/components/cache/index.js');
 require('ioredis');
 require('util');
 require('zlib');

package/dist/cjs/cluster/modules/AutoScaler.js

@@ -3,8 +3,8 @@
 var events = require('events');
 var perf_hooks = require('perf_hooks');
 var pidusage = require('pidusage');
-var errorHandler = require('../../mods/toolkit/src/utils/errorHandler.js');
-var index = require('../../mods/toolkit/src/components/fortified-function/index.js');
+var errorHandler = require('../../mods/security/src/utils/errorHandler.js');
+var index = require('../../mods/security/src/components/fortified-function/index.js');
 var Logger = require('../../server/utils/Logger.js');
 var cluster = require('cluster');
 var os = require('os');

package/dist/cjs/cluster/modules/ClusterPersistenceManager.js

@@ -3,9 +3,9 @@
 var events = require('events');
 var fs = require('fs');
 var path = require('path');
-var index$1 = require('../../mods/toolkit/src/components/fortified-function/index.js');
-var cacheSys = require('../../mods/toolkit/src/components/cache/cacheSys.js');
-var index = require('../../mods/toolkit/src/components/cache/index.js');
+var index$1 = require('../../mods/security/src/components/fortified-function/index.js');
+var cacheSys = require('../../mods/security/src/components/cache/cacheSys.js');
+var index = require('../../mods/security/src/components/cache/index.js');
 var SecureCacheAdapter = require('../../cache/SecureCacheAdapter.js');
 var Logger = require('../../server/utils/Logger.js');
 

package/dist/cjs/cluster/modules/HealthMonitor.js

@@ -3,8 +3,8 @@
 var events = require('events');
 var http = require('http');
 var pidusage = require('pidusage');
-var errorHandler = require('../../mods/toolkit/src/utils/errorHandler.js');
-var index = require('../../mods/toolkit/src/components/fortified-function/index.js');
+var errorHandler = require('../../mods/security/src/utils/errorHandler.js');
+var index = require('../../mods/security/src/components/fortified-function/index.js');
 var Logger = require('../../server/utils/Logger.js');
 
 function _interopNamespaceDefault(e) {

package/dist/cjs/cluster/modules/IPCManager.js

@@ -4,8 +4,8 @@ var events = require('events');
 var crypto = require('crypto');
 var msgpack = require('msgpack-lite');
 var stringify = require('fast-json-stable-stringify');
-var errorHandler = require('../../mods/toolkit/src/utils/errorHandler.js');
-var index = require('../../mods/toolkit/src/components/fortified-function/index.js');
+var errorHandler = require('../../mods/security/src/utils/errorHandler.js');
+var index = require('../../mods/security/src/components/fortified-function/index.js');
 var Logger = require('../../server/utils/Logger.js');
 
 function _interopNamespaceDefault(e) {

package/dist/cjs/cluster/modules/MetricsCollector.js

@@ -2,7 +2,7 @@
 
 var events = require('events');
 var os = require('os');
-var index = require('../../mods/toolkit/src/components/fortified-function/index.js');
+var index = require('../../mods/security/src/components/fortified-function/index.js');
 var Logger = require('../../server/utils/Logger.js');
 
 function _interopNamespaceDefault(e) {

package/dist/cjs/cluster/modules/WorkerManager.js

@@ -4,8 +4,8 @@ var cluster = require('cluster');
 var os = require('os');
 var events = require('events');
 var pidusage = require('pidusage');
-var errorHandler = require('../../mods/toolkit/src/utils/errorHandler.js');
-var index = require('../../mods/toolkit/src/components/fortified-function/index.js');
+var errorHandler = require('../../mods/security/src/utils/errorHandler.js');
+var index = require('../../mods/security/src/components/fortified-function/index.js');
 var Logger = require('../../server/utils/Logger.js');
 
 function _interopNamespaceDefault(e) {

package/dist/cjs/encryption/EncryptionService.js

@@ -1,19 +1,19 @@
 'use strict';
 
-var hashCore = require('../mods/toolkit/src/core/hash/hash-core.js');
-require('../mods/toolkit/src/core/hash/hash-types.js');
+var hashCore = require('../mods/security/src/core/hash/hash-core.js');
+require('../mods/security/src/core/hash/hash-types.js');
 var crypto = require('crypto');
-require('../mods/toolkit/src/core/hash/hash-security.js');
-require('../mods/toolkit/src/core/hash/hash-advanced.js');
-require('../mods/toolkit/src/algorithms/hash-algorithms.js');
-var randomCore = require('../mods/toolkit/src/core/random/random-core.js');
-require('../mods/toolkit/src/core/random/random-types.js');
-require('../mods/toolkit/src/core/random/random-sources.js');
+require('../mods/security/src/core/hash/hash-security.js');
+require('../mods/security/src/core/hash/hash-advanced.js');
+require('../mods/security/src/algorithms/hash-algorithms.js');
+var randomCore = require('../mods/security/src/core/random/random-core.js');
+require('../mods/security/src/core/random/random-types.js');
+require('../mods/security/src/core/random/random-sources.js');
 require('nehonix-uri-processor');
-require('../mods/toolkit/src/utils/memory/index.js');
-require('../mods/toolkit/src/types.js');
-var randomCrypto = require('../mods/toolkit/src/core/random/random-crypto.js');
-var validators = require('../mods/toolkit/src/core/validators.js');
+require('../mods/security/src/utils/memory/index.js');
+require('../mods/security/src/types.js');
+var randomCrypto = require('../mods/security/src/core/random/random-crypto.js');
+var validators = require('../mods/security/src/core/validators.js');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);