xypriss 9.11.13 → 9.12.0

package/dist/src/types/middleware-api.types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * XyPriss Middleware API Types
+ * Comprehensive types for the fluent middleware management API
+ */
+export type MiddlewarePriority = "critical" | "high" | "normal" | "low";
+export interface MiddlewareConfiguration {
+    enabled?: boolean;
+    priority?: MiddlewarePriority;
+    order?: number;
+}
+export interface SecurityMiddlewareConfig {
+    helmet?: boolean | {
+        contentSecurityPolicy?: boolean | object;
+        crossOriginEmbedderPolicy?: boolean;
+        crossOriginOpenerPolicy?: boolean;
+        crossOriginResourcePolicy?: boolean;
+        dnsPrefetchControl?: boolean;
+        frameguard?: boolean | object;
+        hidePoweredBy?: boolean;
+        hsts?: boolean | object;
+        ieNoOpen?: boolean;
+        noSniff?: boolean;
+        originAgentCluster?: boolean;
+        permittedCrossDomainPolicies?: boolean;
+        referrerPolicy?: boolean | object;
+        xssFilter?: boolean;
+    };
+    cors?: boolean | {
+        origin?: string | RegExp | (string | RegExp)[] | boolean;
+        methods?: string | string[];
+        allowedHeaders?: string | string[];
+        exposedHeaders?: string | string[];
+        credentials?: boolean;
+        maxAge?: number;
+        preflightContinue?: boolean;
+        optionsSuccessStatus?: number;
+    };
+    rateLimit?: boolean | {
+        windowMs?: number;
+        max?: number;
+        message?: string | {
+            error?: string;
+            message?: string;
+            retryAfter?: number;
+            [key: string]: any;
+        };
+        standardHeaders?: boolean;
+        legacyHeaders?: boolean;
+        store?: any;
+        keyGenerator?: (req: any) => string;
+        handler?: (req: any, res: any, next: any) => void;
+        onLimitReached?: (req: any, res: any, options: any) => void;
+    };
+    csrf?: boolean | {
+        secret?: string;
+        cookie?: boolean | object;
+        value?: (req: any) => string;
+        ignoreMethods?: string[];
+    };
+    compression?: boolean | {
+        level?: number;
+        threshold?: number;
+        filter?: (req: any, res: any) => boolean;
+        chunkSize?: number;
+        windowBits?: number;
+        memLevel?: number;
+        strategy?: number;
+    };
+}
+export interface BuiltInMiddleware {
+    security: SecurityMiddlewareConfig;
+    logging?: boolean | {
+        format?: string;
+        skip?: (req: any, res: any) => boolean;
+        stream?: any;
+    };
+    bodyParser?: boolean | {
+        json?: boolean | object;
+        urlencoded?: boolean | object;
+        raw?: boolean | object;
+        text?: boolean | object;
+    };
+    static?: boolean | {
+        root: string;
+        options?: object;
+    };
+    session?: boolean | {
+        secret: string;
+        resave?: boolean;
+        saveUninitialized?: boolean;
+        cookie?: object;
+        store?: any;
+    };
+}
+/**
+ * XyPriss Middleware API Interface
+ * Simple, practical interface for middleware management
+ * Extends the base MiddlewareAPIInterface for compatibility
+ */
+export interface XyPrissMiddlewareAPI {
+    /**
+     * Register a custom middleware function
+     */
+    register(middleware: Function, options?: {
+        name?: string;
+        priority?: MiddlewarePriority;
+        routes?: string[];
+    }): XyPrissMiddlewareAPI;
+    /**
+     * Initialize default middleware with security configuration
+     */
+    initializeWithConfig(securityConfig?: import("../types/mod/security").SecurityConfig): void;
+    /**
+     * Configure security middleware bundle
+     */
+    security(config?: SecurityMiddlewareConfig): XyPrissMiddlewareAPI;
+    /**
+     * Configure CORS middleware
+     */
+    cors(config?: SecurityMiddlewareConfig["cors"]): XyPrissMiddlewareAPI;
+    /**
+     * Configure rate limiting middleware
+     */
+    rateLimit(config?: SecurityMiddlewareConfig["rateLimit"]): XyPrissMiddlewareAPI;
+    /**
+     * Configure helmet security headers
+     */
+    helmet(config?: SecurityMiddlewareConfig["helmet"]): XyPrissMiddlewareAPI;
+    /**
+     * Configure CSRF protection
+     */
+    csrf(config?: SecurityMiddlewareConfig["csrf"]): XyPrissMiddlewareAPI;
+    /**
+     * Configure compression middleware
+     */
+    compression(config?: SecurityMiddlewareConfig["compression"]): XyPrissMiddlewareAPI;
+    /**
+     * Get middleware statistics
+     */
+    stats(): {
+        total: number;
+        enabled: number;
+        disabled: number;
+        byType: {
+            custom: number;
+            builtin: number;
+        };
+        byPriority: {
+            critical: number;
+            high: number;
+            normal: number;
+            low: number;
+        };
+    };
+    /**
+     * List all registered middleware
+     */
+    list(): Array<{
+        id: string;
+        name: string;
+        enabled: boolean;
+        priority: MiddlewarePriority;
+        type: "custom" | "builtin";
+    }>;
+    /**
+     * Clear all middleware
+     */
+    clear(): XyPrissMiddlewareAPI;
+    /**
+     * Optimize middleware order by priority
+     */
+    optimize(): XyPrissMiddlewareAPI;
+    unregister(id: string): XyPrissMiddlewareAPI;
+    enable(id: string): XyPrissMiddlewareAPI;
+    disable(id: string): XyPrissMiddlewareAPI;
+    getInfo(id?: string): any;
+    getStats(): any;
+    getConfig(): any;
+}
+//# sourceMappingURL=middleware-api.types.d.ts.map

package/dist/src/types/middleware-api.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-api.types.d.ts","sourceRoot":"","sources":["../../../src/types/middleware-api.types.ts"],"names":[],"mappings":"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"}

package/dist/src/types/middleware-api.types.js

@@ -0,0 +1,6 @@
+/**
+ * XyPriss Middleware API Types
+ * Comprehensive types for the fluent middleware management API
+ */
+export {};
+//# sourceMappingURL=middleware-api.types.js.map

package/dist/src/types/middleware-api.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-api.types.js","sourceRoot":"","sources":["../../../src/types/middleware-api.types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/types/middlewareManager.types.d.ts

@@ -0,0 +1,18 @@
+import { MiddlewareFunction } from "./httpServer.type";
+/**
+ * Middleware configuration
+ */
+export interface MiddlewareConfig {
+    name: string;
+    enabled: boolean;
+    priority: number;
+    description?: string;
+}
+/**
+ * Middleware entry
+ */
+export interface MiddlewareEntry {
+    config: MiddlewareConfig;
+    handler: MiddlewareFunction;
+}
+//# sourceMappingURL=middlewareManager.types.d.ts.map

package/dist/src/types/middlewareManager.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareManager.types.d.ts","sourceRoot":"","sources":["../../../src/types/middlewareManager.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,kBAAkB,CAAC;CAC/B"}

package/dist/src/types/middlewareManager.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=middlewareManager.types.js.map

package/dist/src/types/middlewareManager.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareManager.types.js","sourceRoot":"","sources":["../../../src/types/middlewareManager.types.ts"],"names":[],"mappings":""}

package/dist/src/types/mod/cache.d.ts

@@ -0,0 +1,417 @@
+/**
+ * @fileoverview Cache-related type definitions for XyPriss integration
+ *
+ * This module contains all cache-related types including configuration,
+ * strategies, metrics, and backend implementations.
+ *
+ * @version 4.5.11
+ * @author XyPrissJS Team
+ * @since 2025-01-06
+ */
+import { Request } from "../types";
+/**
+ * Cache backend strategy types.
+ *
+ * Defines the available cache backend implementations:
+ * - memory: In-memory caching (fastest, not persistent)
+ * - redis: Redis-based caching (persistent, distributed)
+ * - hybrid: Combination of memory and Redis
+ * - distributed: Multi-node distributed caching
+ *
+ * @example
+ * ```typescript
+ * const strategy: CacheBackendStrategy = 'hybrid';
+ * ```
+ */
+export type CacheBackendStrategy = "memory" | "redis" | "hybrid" | "distributed";
+/**
+ * Main cache configuration interface.
+ *
+ * Comprehensive configuration for the caching system including
+ * backend selection, performance tuning, security, and monitoring.
+ *
+ * @interface CacheConfig
+ *
+ * @example
+ * ```typescript
+ * const cacheConfig: CacheConfig = {
+ *   type: 'hybrid',
+ *   ttl: 3600,
+ *   maxSize: 1024 * 1024 * 100, // 100MB
+ *   compression: true,
+ *   encryption: true,
+ *   strategies: [
+ *     {
+ *       name: 'api-cache',
+ *       condition: (req) => req.path.startsWith('/api/'),
+ *       ttl: 300,
+ *       tags: ['api']
+ *     }
+ *   ]
+ * };
+ * ```
+ */
+export interface CacheConfig {
+    /** Cache backend type */
+    type?: CacheBackendStrategy;
+    /** Redis configuration (when using Redis backend) */
+    redis?: RedisConfig;
+    /** Memory cache configuration */
+    memory?: MemoryConfig;
+    /** Default TTL in seconds */
+    ttl?: number;
+    /** Maximum cache size in bytes */
+    maxSize?: number;
+    /** Maximum number of cache entries */
+    maxEntries?: number;
+    /** Enable compression for cached data */
+    compression?: boolean;
+    /** Enable encryption for cached data */
+    encryption?: boolean;
+    /** Serialization format for cached data */
+    serialization?: "json" | "msgpack" | "protobuf";
+    /** Cache strategies for different scenarios */
+    strategies?: CacheStrategy[];
+    /** Enable singleton pattern for cache instances */
+    singleton?: boolean;
+    /** Performance optimization settings */
+    performance?: CachePerformanceConfig;
+    /** Security settings for cache */
+    security?: CacheSecurityConfig;
+    /** Monitoring and metrics configuration */
+    monitoring?: CacheMonitoringConfig;
+    /** Resilience and fault tolerance settings */
+    resilience?: CacheResilienceConfig;
+}
+/**
+ * Redis cache configuration.
+ *
+ * Comprehensive Redis configuration including clustering,
+ * connection pooling, and high availability options.
+ *
+ * @interface RedisConfig
+ *
+ * @example
+ * ```typescript
+ * const redisConfig: RedisConfig = {
+ *   host: 'localhost',
+ *   port: 6379,
+ *   password: 'secure-password',
+ *   cluster: true,
+ *   nodes: [
+ *     { host: 'redis-1', port: 6379 },
+ *     { host: 'redis-2', port: 6379 }
+ *   ],
+ *   pool: {
+ *     min: 5,
+ *     max: 20,
+ *     acquireTimeoutMillis: 5000
+ *   }
+ * };
+ * ```
+ */
+export interface RedisConfig {
+    /** Redis server hostname */
+    host?: string;
+    /** Redis server port */
+    port?: number;
+    /** Redis authentication password */
+    password?: string;
+    /** Redis database number */
+    db?: number;
+    /** Enable Redis cluster mode */
+    cluster?: boolean;
+    /** Cluster nodes configuration */
+    nodes?: Array<{
+        host: string;
+        port: number;
+    }>;
+    /** Sharded Redis configuration with weights */
+    shards?: Array<{
+        host: string;
+        port: number;
+        weight?: number;
+    }>;
+    /** Redis connection options */
+    options?: {
+        /** Retry delay on failover in milliseconds */
+        retryDelayOnFailover?: number;
+        /** Maximum retries per request */
+        maxRetriesPerRequest?: number;
+        /** Enable lazy connection */
+        lazyConnect?: boolean;
+    };
+    /** Connection pool configuration */
+    pool?: {
+        /** Minimum connections in pool */
+        min?: number;
+        /** Maximum connections in pool */
+        max?: number;
+        /** Timeout for acquiring connection in milliseconds */
+        acquireTimeoutMillis?: number;
+        /** Idle timeout for connections in milliseconds */
+        idleTimeoutMillis?: number;
+    };
+    /** Redis Sentinel configuration for high availability */
+    sentinel?: {
+        /** Enable Sentinel mode */
+        enabled?: boolean;
+        /** Master names to monitor */
+        masters?: string[];
+        /** Sentinel server configurations */
+        sentinels?: Array<{
+            host: string;
+            port: number;
+        }>;
+    };
+}
+/**
+ * Memory cache configuration.
+ *
+ * Configuration for in-memory caching including eviction
+ * policies and memory management.
+ *
+ * @interface MemoryConfig
+ *
+ * @example
+ * ```typescript
+ * const memoryConfig: MemoryConfig = {
+ *   maxSize: 1024 * 1024 * 50, // 50MB
+ *   algorithm: 'lru',
+ *   evictionPolicy: 'lru',
+ *   checkPeriod: 60000, // 1 minute
+ *   preallocation: true
+ * };
+ * ```
+ */
+export interface MemoryConfig {
+    /** Maximum memory size in bytes */
+    maxSize?: number;
+    /** Heap size allocation in bytes (alias for maxSize) */
+    heapSize?: number;
+    /** Cleanup interval in milliseconds (alias for checkPeriod) */
+    cleanupInterval?: number;
+    /** Cache algorithm */
+    algorithm?: "lru" | "lfu" | "fifo";
+    /** Eviction policy when cache is full */
+    evictionPolicy?: "lru" | "lfu" | "fifo" | "ttl";
+    /** Check period for expired entries in milliseconds */
+    checkPeriod?: number;
+    /** Enable memory preallocation for better performance */
+    preallocation?: boolean;
+}
+/**
+ * Cache performance optimization configuration.
+ *
+ * Settings for optimizing cache performance including
+ * batching, compression, and connection management.
+ *
+ * @interface CachePerformanceConfig
+ *
+ * @example
+ * ```typescript
+ * const perfConfig: CachePerformanceConfig = {
+ *   batchSize: 100,
+ *   compressionThreshold: 1024,
+ *   hotDataThreshold: 0.8,
+ *   prefetchEnabled: true,
+ *   asyncWrite: true,
+ *   pipeline: true
+ * };
+ * ```
+ */
+export interface CachePerformanceConfig {
+    /** Batch size for bulk operations */
+    batchSize?: number;
+    /** Minimum size threshold for compression in bytes */
+    compressionThreshold?: number;
+    /** Threshold for identifying hot data (0-1) */
+    hotDataThreshold?: number;
+    /** Enable prefetching of related data */
+    prefetchEnabled?: boolean;
+    /** Enable asynchronous write operations */
+    asyncWrite?: boolean;
+    /** Enable Redis pipelining for better performance */
+    pipeline?: boolean;
+    /** Enable connection pooling */
+    connectionPooling?: boolean;
+}
+/**
+ * Cache security configuration.
+ *
+ * Security settings for cache including encryption,
+ * access monitoring, and audit logging.
+ *
+ * @interface CacheSecurityConfig
+ *
+ * @example
+ * ```typescript
+ * const securityConfig: CacheSecurityConfig = {
+ *   encryption: true,
+ *   keyRotation: true,
+ *   accessMonitoring: true,
+ *   sanitization: true,
+ *   auditLogging: true
+ * };
+ * ```
+ */
+export interface CacheSecurityConfig {
+    /** Enable data encryption */
+    encryption?: boolean;
+    /** Enable automatic key rotation */
+    keyRotation?: boolean;
+    /** Enable access monitoring and logging */
+    accessMonitoring?: boolean;
+    /** Enable data sanitization */
+    sanitization?: boolean;
+    /** Enable audit logging */
+    auditLogging?: boolean;
+}
+/**
+ * Cache monitoring configuration.
+ *
+ * Settings for monitoring cache performance and health
+ * including metrics collection and alerting.
+ *
+ * @interface CacheMonitoringConfig
+ *
+ * @example
+ * ```typescript
+ * const monitoringConfig: CacheMonitoringConfig = {
+ *   enabled: true,
+ *   metricsInterval: 30000, // 30 seconds
+ *   alertThresholds: {
+ *     memoryUsage: 0.85,
+ *     hitRate: 0.7,
+ *     errorRate: 0.05,
+ *     latency: 100
+ *   },
+ *   detailed: true
+ * };
+ * ```
+ */
+export interface CacheMonitoringConfig {
+    /** Enable monitoring */
+    enabled?: boolean;
+    /** Metrics collection interval in milliseconds */
+    metricsInterval?: number;
+    /** Alert thresholds for various metrics */
+    alertThresholds?: {
+        /** Memory usage threshold (0-1) */
+        memoryUsage?: number;
+        /** Cache hit rate threshold (0-1) */
+        hitRate?: number;
+        /** Error rate threshold (0-1) */
+        errorRate?: number;
+        /** Latency threshold in milliseconds */
+        latency?: number;
+    };
+    /** Enable detailed metrics collection */
+    detailed?: boolean;
+}
+/**
+ * Cache resilience configuration.
+ *
+ * Settings for fault tolerance including retry logic,
+ * circuit breakers, and fallback mechanisms.
+ *
+ * @interface CacheResilienceConfig
+ *
+ * @example
+ * ```typescript
+ * const resilienceConfig: CacheResilienceConfig = {
+ *   retryAttempts: 3,
+ *   retryDelay: 1000,
+ *   circuitBreaker: true,
+ *   fallback: true,
+ *   healthCheck: true
+ * };
+ * ```
+ */
+export interface CacheResilienceConfig {
+    /** Number of retry attempts for failed operations */
+    retryAttempts?: number;
+    /** Delay between retry attempts in milliseconds */
+    retryDelay?: number;
+    /** Enable circuit breaker pattern */
+    circuitBreaker?: boolean;
+    /** Enable fallback to alternative cache */
+    fallback?: boolean;
+    /** Enable health check monitoring */
+    healthCheck?: boolean;
+}
+/**
+ * Cache metrics interface.
+ *
+ * Real-time metrics for cache performance monitoring
+ * and optimization.
+ *
+ * @interface CacheMetrics
+ *
+ * @example
+ * ```typescript
+ * const metrics: CacheMetrics = {
+ *   hits: 1500,
+ *   misses: 300,
+ *   sets: 800,
+ *   deletes: 50,
+ *   errors: 2,
+ *   operations: 2650,
+ *   hitRate: 0.83,
+ *   missRate: 0.17,
+ *   errorRate: 0.0008,
+ *   totalMemory: 52428800 // 50MB
+ * };
+ * ```
+ */
+export interface CacheMetrics {
+    /** Number of cache hits */
+    hits: number;
+    /** Number of cache misses */
+    misses: number;
+    /** Number of set operations */
+    sets: number;
+    /** Number of delete operations */
+    deletes: number;
+    /** Number of errors */
+    errors: number;
+    /** Total number of operations */
+    operations: number;
+    /** Cache hit rate (calculated) */
+    hitRate?: number;
+    /** Cache miss rate (calculated) */
+    missRate?: number;
+    /** Error rate (calculated) */
+    errorRate?: number;
+    /** Total memory usage in bytes */
+    totalMemory?: number;
+}
+/**
+ * Cache strategy configuration.
+ *
+ * Defines conditional caching strategies based on
+ * request characteristics and business logic.
+ *
+ * @interface CacheStrategy
+ *
+ * @example
+ * ```typescript
+ * const apiStrategy: CacheStrategy = {
+ *   name: 'api-endpoints',
+ *   condition: (req) => req.path.startsWith('/api/') && req.method === 'GET',
+ *   ttl: 300, // 5 minutes
+ *   tags: ['api', 'public']
+ * };
+ * ```
+ */
+export interface CacheStrategy {
+    /** Strategy name for identification */
+    name: string;
+    /** Condition function to determine if strategy applies */
+    condition: (req: Request) => boolean;
+    /** TTL for this strategy in seconds */
+    ttl: number;
+    /** Tags for cache invalidation */
+    tags?: string[];
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/types/mod/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../src/types/mod/cache.ts"],"names":[],"mappings":"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"}

package/dist/src/types/mod/cache.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Cache-related type definitions for XyPriss integration
+ *
+ * This module contains all cache-related types including configuration,
+ * strategies, metrics, and backend implementations.
+ *
+ * @version 4.5.11
+ * @author XyPrissJS Team
+ * @since 2025-01-06
+ */
+export {};
+//# sourceMappingURL=cache.js.map

package/dist/src/types/mod/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../src/types/mod/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}