xypriss 9.11.13 → 9.12.0

package/dist/src/types/httpServer.type.d.ts

@@ -0,0 +1,258 @@
+/***************************************************************************
+ * XyPriss - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ *
+ * This License governs the use, modification, and distribution of software
+ * provided by NEHONIX under its open source projects.
+ * NEHONIX is committed to fostering collaborative innovation while strictly
+ * protecting its intellectual property rights.
+ * Violation of any term of this License will result in immediate termination of all granted rights
+ * and may subject the violator to legal action.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
+ * AND NON-INFRINGEMENT.
+ * IN NO EVENT SHALL NEHONIX BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+ * OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR INABILITY TO USE THE SOFTWARE,
+ * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+ *
+ ***************************************************************************** */
+import { IncomingMessage, ServerResponse } from "http";
+import { XemsRunner } from "../plugins/builtin/xems/XemsPlugin";
+export interface XyAppInternal {
+    get: (key: string) => any;
+    set: (key: string, value: any) => void;
+    pluginManager?: any;
+    xems?: XemsRunner;
+    [key: string]: any;
+}
+export interface IFile {
+    fieldname: string;
+    originalname: string;
+    encoding: "7bit" | "8bit" | "binary" | string;
+    mimetype: `${string}/${string}`;
+    destination: string;
+    filename: string;
+    path: string;
+    size: number;
+    [key: string]: any;
+}
+/**
+ * XyPriss Request interface (Express-compatible)
+ */
+export interface XyPrisRequest extends IncomingMessage {
+    params: Record<string, string>;
+    query: Record<string, any>;
+    body: any;
+    files?: IFile[];
+    file?: IFile;
+    csrfToken?: () => string;
+    path: string;
+    originalUrl: string;
+    baseUrl: string;
+    route?: any;
+    session?: any;
+    user?: any;
+    headers: IncomingMessage["headers"];
+    method: string;
+    url: string;
+    ip: string;
+    ips: string[];
+    cookies: Record<string, string>;
+    app: XyAppInternal;
+    protocol: string;
+    secure: boolean;
+    hostname: string;
+    subdomains: string[];
+    fresh: boolean;
+    stale: boolean;
+    xhr: boolean;
+    get: (name: string) => string | undefined;
+    /**
+     * Redirect the current request to another URL.
+     * This is a DX (Developer Experience) convenience alias for `res.redirect()`.
+     *
+     * **Difference between `req.redirect` and `res.redirect`:**
+     * - `res.redirect()`: Standard HTTP way to respond with a redirect.
+     * - `req.redirect()`: Utility alias to trigger a redirect when you only have access
+     *   to the request object, or for semantic consistency with `req.forward()`.
+     *
+     * Both methods perform the exact same action: sending a 301/302 response and ending it.
+     *
+     * @param url - The target URL (relative or absolute).
+     * @param status - HTTP status code (default: 302).
+     *
+     * @example
+     * ```typescript
+     * // Using req as a controller shortcut
+     * if (!user.isAdmin) return req.redirect("/login");
+     * ```
+     */
+    redirect(url: string): void;
+    redirect(status: number, url: string): void;
+    /**
+     * **Server-Side Forward (req.forward)**
+     *
+     * Asynchronously forwards the current request to another endpoint (internal path or external URL)
+     * and returns the response data. This is NOT a browser-side redirect; the operation
+     * happens entirely on the server.
+     *
+     * **Features:**
+     * - **Data Continuity**: By default, it inherits method, body, and headers from the original request.
+     * - **Auto-resolution**: Paths like `/api/v1` are automatically resolved against `localhost:[current_port]`.
+     * - **Auto-parsing**: Automatically parses JSON responses if the `Content-Type` is `application/json`.
+     *
+     * @param url - Target path (e.g., "/internal-api") or full URL.
+     * @param options - Optional overrides (method, headers, body, or any `fetch` option).
+     * @returns Promise resolving to the parsed body (Object for JSON, string for text).
+     *
+     * @example
+     * ```typescript
+     * app.get("/profile", async (req, res) => {
+     *    // Forward request to an internal auth service to get user details
+     *    const user = await req.forward("/internal/auth/check");
+     *
+     *    if (user.isBlocked) return res.status(403).send("Blocked");
+     *    res.render("profile", { user });
+     * });
+     * ```
+     */
+    forward<T = any>(url: string, options?: any): Promise<T>;
+}
+export interface SendFileOptions {
+    maxAge?: number;
+    headers?: Record<string, string>;
+    root?: string;
+    /**
+     * "inline"     → browser renders the file (default)
+     * "attachment" → browser downloads the file
+     * string       → treated as custom filename, forces attachment
+     */
+    disposition?: "inline" | "attachment" | string;
+    /** Override or extend the built-in MIME map for this request. */
+    mimeOverrides?: Record<string, string>;
+}
+/**
+ * XyPriss Response interface (Express-compatible)
+ */
+export interface XyPrisResponse extends ServerResponse {
+    /**
+     * Serializes `data` to JSON and sends it as the response body with
+     * `Content-Type: application/json`.
+     *
+     * @param data - The value to serialize. Must be JSON-serializable.
+     *               Use {@link xJson} instead if `data` may contain circular references.
+     *
+     * @typeParam T - The type of the value being serialized.
+     *
+     * @example
+     * res.json({ id: 1, name: "Alice" });
+     */
+    json<T>(data: T): void;
+    /**
+     * Sends an HTML response to the client.
+     * @param htmlString - The HTML string to send.
+     */
+    html(htmlString: string): void;
+    /**
+     * Sends a response to the client.
+     * @param data - The data to send.
+     */
+    send<T>(data: T): void;
+    /**
+     * Sends a file to the client.
+     * @param filePath - The path to the file to send.
+     * @param options - Optional send file options.
+     */
+    sendFile(filePath: string, options?: SendFileOptions): Promise<void> | void;
+    /**
+     * Sets the HTTP status code for the response.
+     * @param code - The HTTP status code.
+     */
+    status(code: number): XyPrisResponse;
+    /**
+     * Sets a response header.
+     * @param name - The header name.
+     * @param value - The header value.
+     */
+    setHeader(name: string, value: string | number | readonly string[]): this;
+    /**
+     * Gets a response header.
+     * @param name - The header name.
+     * @returns The header value.
+     */
+    getHeader(name: string): string | number | string[] | undefined;
+    removeHeader(name: string): void;
+    set(field: string | Record<string, any>, value?: string | number | readonly string[]): XyPrisResponse;
+    redirect(url: string): void;
+    redirect(status: number, url: string): void;
+    cookie(name: string, value: string, options?: any): void;
+    clearCookie(name: string, options?: any): void;
+    locals: Record<string, any>;
+    headersSent: boolean;
+    get: (name: string) => string | number | string[] | undefined;
+    /**
+     * The XJson API is an advanced JSON response handler
+     * designed to solve serialization issues and handle
+     * large data responses without limitations. It provides
+     * enhanced JSON serialization capabilities that overcome
+     * common problems with standard JSON responses, particularly
+     * for complex data structures and large payloads.
+     * @see {@link https://xypriss.nehonix.com/docs/XJSON_API?kw=XJson%20API}
+     */
+    xJson<T>(data: T): void;
+    /**
+     * Initializes a secure XEMS session and links it to the response.
+     * This automatically generates a token, stores the data in the "XEMS" core,
+     * and sets the necessary security headers and cookies.
+     * @param data The data to store in the session
+     * @param sandbox Optional sandbox name to use (defaults to configuration)
+     */
+    xLink<T>(data: T, options?: {
+        sandbox?: string;
+        attachTo?: string;
+        ttl?: string;
+    } | string): Promise<string>;
+    xUnlink(options?: {
+        sandbox?: string;
+        attachTo?: string;
+    } | string): Promise<void>;
+    /**
+     * Sends a successful JSON response with a message and optional data.
+     * @param message - Success message.
+     * @param data - Optional data payload.
+     */
+    success(message: string, data?: any): void;
+}
+/**
+ * Middleware function type
+ */
+/**
+ * Middleware function type
+ */
+export type MiddlewareFunction = (...args: any[]) => void | Promise<void>;
+/**
+ * Next function type
+ */
+export type NextFunction = (error?: any) => void;
+/**
+ * Route handler type
+ */
+export type RouteHandler = (req: XyPrisRequest, res: XyPrisResponse, next?: NextFunction) => void | Promise<void>;
+/**
+ * Route definition
+ */
+export interface Route {
+    method: string;
+    path: string | RegExp;
+    handler: RouteHandler;
+    middleware: MiddlewareFunction[];
+    paramNames?: string[];
+    target?: string;
+    filePath?: string;
+}
+//# sourceMappingURL=httpServer.type.d.ts.map

package/dist/src/types/httpServer.type.d.ts.map

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

package/dist/src/types/httpServer.type.js

@@ -0,0 +1,25 @@
+/***************************************************************************
+ * XyPriss - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ *
+ * This License governs the use, modification, and distribution of software
+ * provided by NEHONIX under its open source projects.
+ * NEHONIX is committed to fostering collaborative innovation while strictly
+ * protecting its intellectual property rights.
+ * Violation of any term of this License will result in immediate termination of all granted rights
+ * and may subject the violator to legal action.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
+ * AND NON-INFRINGEMENT.
+ * IN NO EVENT SHALL NEHONIX BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+ * OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR INABILITY TO USE THE SOFTWARE,
+ * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+ *
+ ***************************************************************************** */
+export {};
+//# sourceMappingURL=httpServer.type.js.map

package/dist/src/types/httpServer.type.js.map

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

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

@@ -0,0 +1,228 @@
+/**
+ * @fileoverview Main export file for XyPriss integration types
+ *
+ * This file provides a centralized export point for all XyPriss integration
+ * types, organized into modular categories for better maintainability.
+ *
+ * @version 4.5.11
+ * @author XyPrissJS Team
+ * @since 2025-01-06
+ *
+ * @example
+ * ```typescript
+ * // Import all types
+ * import * as XyPrissTypes from './types';
+ *
+ * // Import specific categories
+ * import { CacheConfig, SecurityConfig } from './types';
+ *
+ * // Import from specific modules
+ * import { PerformanceMetrics } from './types/performance';
+ * import { RouteConfig } from './types/routing';
+ * ```
+ */
+export * from "./types";
+export * as Core from "./mod/core";
+export * as Cache from "./mod/cache";
+export * as Security from "./mod/security";
+export * as Performance from "./mod/performance";
+export * as Routing from "./mod/routing";
+export * as Monitoring from "./mod/monitoring";
+export type { DeepPartial, EnhancedRequest, EnhancedResponse, RouteHandler, MiddlewareFunction, ValidationResult, UserContext, SessionData, PaginationInfo, } from "./mod/core";
+export type { AlertConfig as CoreAlertConfig } from "./mod/core";
+export type { CacheConfig, CacheBackendStrategy, RedisConfig, MemoryConfig, CacheMetrics, CacheStrategy, CachePerformanceConfig, CacheSecurityConfig, CacheMonitoringConfig, CacheResilienceConfig, } from "./mod/cache";
+export type { SecurityConfig, SecurityLevel, EncryptionConfig, SessionCookieConfig, RouteSecurityConfig, RoutePattern, } from "./mod/security";
+export type { SSLConfig as SecuritySSLConfig, CORSConfig as SecurityCORSConfig, RateLimitConfig as SecurityRateLimitConfig, } from "./mod/security";
+export type { PerformanceConfig, PerformanceOptimizationConfig, PerformanceMetrics, PerformanceMonitoringConfig, PerformanceProfilerConfig, PerformanceBenchmark, } from "./mod/performance";
+export type { AlertConfig as PerformanceAlertConfig } from "./mod/performance";
+export type { HttpMethod, RouteConfig, RouteCacheConfig, RouteValidationConfig, RouteOptions, RouterConfig, RouteStats, } from "./mod/routing";
+export type { RouteRateLimitConfig as RoutingRateLimitConfig } from "./mod/routing";
+export type { MonitoringConfig, HealthCheckConfig, HealthCheck, HealthCheckResult, SystemMetrics, AlertCondition, AlertAction, ObservabilityConfig, } from "./mod/monitoring";
+export type { AlertConfig as MonitoringAlertConfig } from "./mod/monitoring";
+export type { ServerOptions, XyPrissApp, XyPrissMiddlewareHandler, } from "./types";
+import { XyPrissXHSC } from "../xhsc";
+import { Configs } from "../ConfigurationManager";
+import { XyPrissConst } from "../const";
+import { XServerOptions } from "./ServerOptions";
+declare global {
+    /**
+     * **XyPriss System Variables Manager (`__sys__`)**
+     *
+     * Provides centralized access to system-level variables, environment detection, and dynamic
+     * configuration management. This global instance serves as a type-safe wrapper around
+     * application metadata and environment utilities.
+     *
+     * @global
+     * @type {XyPrissXHSC}
+     *
+     * @example
+     * ```typescript
+     * // Environment Detection
+     * if (__sys__.__env__.isProduction()) {
+     *   console.log("Running in production mode");
+     * }
+     *
+     * // Dynamic Variable Management
+     * __sys__.vars.set("appName", "MyXyPrissApp");
+     * const version = __sys__.vars.get("version", "1.0.0");
+     *
+     * // Bulk Update
+     * __sys__.vars.update({
+     *   author: "Nehonix",
+     *   debug: true
+     * });
+     * ```
+     *
+     * @see {@link https://xypriss.nehonix.com/docs/features/sys-globals?kw=the%20__sys__}
+     */
+    var __sys__: XyPrissXHSC;
+    /**
+     * **XyPriss Configuration Manager (`__cfg__`)**
+     *
+     * A singleton interface for managing the core XyPriss server configuration.
+     * It handles deep merging of options, default values, and provides a single source
+     * of truth for all server components (security, performance, routing, etc.).
+     *
+     * @global
+     * @type {typeof Configs}
+     *
+     * @example
+     * ```typescript
+     * // Accessing Configuration
+     * const serverPort = __cfg__.get("server")?.port;
+     * const isSecurityEnabled = __cfg__.get("security")?.enabled;
+     *
+     * // Updating Configuration (Deep Merge)
+     * __cfg__.update("performance", {
+     *   slowRequestThreshold: 1000
+     * });
+     *
+     * // Check Initialization State
+     * if (__cfg__.isInitialized()) {
+     *   console.log("Server configuration is ready");
+     * }
+     * ```
+     *
+     * @see {@link https://github.com/Nehonix-Team/XyPriss/blob/master/docs/CFG_API.md}
+     */
+    var __cfg__: typeof Configs;
+    /**
+     * **XyPriss Immutable Constants (`__const__`)**
+     *
+     * A global registry for immutable application constants. Once a value is set
+     * via `__const__.vars.set()`, it cannot be modified or redefined, ensuring
+     * data integrity across the entire application lifecycle.
+     *
+     * @global
+     * @type {XyPrissConst}
+     * @version 3.0.0
+     *
+     * @example
+     * ```typescript
+     * // Defining a constant (only once)
+     * __const__.vars.set('SERVER_PORT', 8080);
+     *
+     * // Attempting to redefine will throw an error
+     * try {
+     *   __const__.vars.set('SERVER_PORT', 9000);
+     * } catch (e) {
+     *   console.error(e.message); // Cannot redefine constant "SERVER_PORT"
+     * }
+     *
+     * // Accessing a constant
+     * const port = __const__.vars.get('SERVER_PORT');
+     *
+     * // Making an object deeply immutable
+     * const config = __const__.vars.make({ port: 8080 });
+     * config.port = 9000; // Throws error!
+     * ```
+     *@see {@link https://github.com/Nehonix-Team/XyPriss/blob/master/docs/CONST_API.md}
+     * @see {@link https://github.com/Nehonix-Team/XyPriss/blob/master/docs/GLOBAL_APIS.md}
+     */
+    var __const__: XyPrissConst;
+    /**
+     * @fileoverview Comprehensive server options interface for XyPriss integration
+     *
+     * This interface provides complete configuration options for creating high-performance,
+     * secure servers with advanced features including caching, clustering,
+     * performance optimization, and Go integration.
+     *
+     * @interface ServerOptions
+     * @version 4.5.11
+     * @author XyPrissJS Team
+     * @since 2025-01-06
+     *
+     * @example
+     * ```typescript
+     * import { createServer, ServerOptions } from 'xypriss';
+     *
+     * const serverOptions: ServerOptions = {
+     *   env: 'production',
+     *   cache: {
+     *     strategy: 'hybrid',
+     *     maxSize: 1024 * 1024 * 100, // 100MB
+     *     ttl: 3600,
+     *     enabled: true,
+     *     enableCompression: true
+     *   },
+     *   security: {
+     *     encryption: true,
+     *     cors: true,
+     *     helmet: true
+     *   },
+     *   performance: {
+     *     optimizationEnabled: true,
+     *     aggressiveCaching: true,
+     *     parallelProcessing: true
+     *   },
+     *   server: {
+     *     port: 3000,
+     *     host: '0.0.0.0',
+     *     autoPortSwitch: {
+     *       enabled: true,
+     *       maxAttempts: 5
+     *     }
+     *   }
+     * };
+     *
+     * const app = createServer(serverOptions);
+     * ```
+     */
+    type ServerOptions = XServerOptions;
+}
+export { XyPrissXHSC, XyPrissConst };
+type BunSubprocess = {
+    exited: Promise<number | null>;
+    kill: (signal?: string) => void;
+    killed: boolean;
+    pid: number;
+    stdout?: ReadableStream<Uint8Array>;
+    stderr?: ReadableStream<Uint8Array>;
+    stdin?: WritableStream<Uint8Array>;
+};
+export interface BunWorker {
+    id: string;
+    subprocess: BunSubprocess;
+    port: number;
+    status: "starting" | "running" | "stopping" | "stopped" | "error";
+    startTime: number;
+    restarts: number;
+    lastPing: number;
+    health: {
+        status: "healthy" | "unhealthy" | "unknown";
+        consecutiveFailures: number;
+        lastError?: string;
+    };
+}
+export interface BunClusterMetrics {
+    totalWorkers: number;
+    activeWorkers: number;
+    totalRequests: number;
+    averageResponseTime: number;
+    memoryUsage: number;
+    cpuUsage: number;
+    uptime: number;
+    errorRate: number;
+    restartCount: number;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/types/index.js

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Main export file for XyPriss integration types
+ *
+ * This file provides a centralized export point for all XyPriss integration
+ * types, organized into modular categories for better maintainability.
+ *
+ * @version 4.5.11
+ * @author XyPrissJS Team
+ * @since 2025-01-06
+ *
+ * @example
+ * ```typescript
+ * // Import all types
+ * import * as XyPrissTypes from './types';
+ *
+ * // Import specific categories
+ * import { CacheConfig, SecurityConfig } from './types';
+ *
+ * // Import from specific modules
+ * import { PerformanceMetrics } from './types/performance';
+ * import { RouteConfig } from './types/routing';
+ * ```
+ */
+// Export all types from the main types file (includes legacy compatibility)
+export * from "./types";
+// Export modular type categories for direct access
+export * as Core from "./mod/core";
+export * as Cache from "./mod/cache";
+export * as Security from "./mod/security";
+export * as Performance from "./mod/performance";
+export * as Routing from "./mod/routing";
+export * as Monitoring from "./mod/monitoring";
+// Bun-specific types and imports
+import { XyPrissXHSC } from "../xhsc";
+import { XyPrissConst } from "../const";
+export { XyPrissXHSC, XyPrissConst };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,4EAA4E;AAC5E,cAAc,SAAS,CAAC;AAExB,mDAAmD;AACnD,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAmG/C,iCAAiC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA0JxC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC"}