xypriss 9.3.62 → 9.3.64

package/.xypriss-compression-dev/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nehonix Team
+
+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.

package/.xypriss-compression-dev/README.md

@@ -0,0 +1,229 @@
+# XyPriss Compression
+
+Custom compression middleware for Express/Connect with strict algorithm enforcement.
+
+## Key Feature
+
+Unlike the standard `compression` package, `xypriss-compression` enforces which compression algorithms can be used. If you configure `algorithms: ['br', 'deflate']`, it will never use gzip, even if the client requests it.
+
+## Problem Solved
+
+The original `compression` package has no way to restrict which algorithms are used. It automatically chooses based on the client's `Accept-Encoding` header, ignoring your configuration.
+
+**Example of the problem:**
+
+```javascript
+// Using standard 'compression' package
+const compression = require("compression");
+app.use(
+  compression({
+    // This option doesn't exist!
+    // algorithms: ['br', 'deflate']
+  })
+);
+
+// Client requests gzip → Server uses gzip (no control!)
+```
+
+**With xypriss-compression:**
+
+```typescript
+import compression from "xypriss-compression-pluging";
+
+app.use(
+  compression({
+    algorithms: ["br", "deflate"], // STRICTLY ENFORCED
+  })
+);
+
+// Client requests gzip → Server responds with identity (uncompressed)
+// Client requests br → Server uses brotli
+// Client requests deflate → Server uses deflate
+```
+
+## Installation
+
+```bash
+npm install xypriss-compression
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import express from "express";
+import compression from "xypriss-compression-pluging";
+
+const app = express();
+
+// Use with default settings (gzip, deflate)
+app.use(compression());
+
+app.listen(3000);
+```
+
+### With Algorithm Enforcement
+
+```typescript
+import compression from "xypriss-compression-pluging";
+
+app.use(
+  compression({
+    // Only allow Brotli and Deflate
+    algorithms: ["br", "deflate"],
+
+    // Compression level (1-9 for gzip/deflate, 0-11 for brotli)
+    level: 6,
+
+    // Minimum size to compress (1KB)
+    threshold: "1kb",
+  })
+);
+```
+
+### Advanced Configuration
+
+```typescript
+app.use(
+  compression({
+    algorithms: ["br", "gzip"],
+    level: 9,
+    threshold: 2048,
+
+    // Custom filter
+    filter: (req, res) => {
+      // Don't compress images
+      const type = res.getHeader("Content-Type");
+      if (type && type.toString().startsWith("image/")) {
+        return false;
+      }
+      return true;
+    },
+
+    // Brotli-specific options
+    brotli: {
+      params: {
+        [zlib.constants.BROTLI_PARAM_MODE]: zlib.constants.BROTLI_MODE_TEXT,
+      },
+    },
+
+    // Gzip-specific options
+    gzip: {
+      memLevel: 8,
+    },
+  })
+);
+```
+
+## API
+
+### `compression(options?)`
+
+Creates a compression middleware.
+
+#### Options
+
+| Option       | Type                                 | Default               | Description                                               |
+| ------------ | ------------------------------------ | --------------------- | --------------------------------------------------------- |
+| `algorithms` | `Array<'gzip' \| 'deflate' \| 'br'>` | `['gzip', 'deflate']` | Strictly enforced list of allowed algorithms              |
+| `level`      | `number`                             | `6`                   | Compression level (1-9 for gzip/deflate, 0-11 for brotli) |
+| `threshold`  | `number \| string`                   | `1024`                | Minimum response size to compress                         |
+| `filter`     | `Function`                           | `shouldCompress`      | Custom filter function                                    |
+| `brotli`     | `BrotliOptions`                      | `{}`                  | Brotli-specific options                                   |
+| `gzip`       | `ZlibOptions`                        | `{}`                  | Gzip-specific options                                     |
+| `deflate`    | `ZlibOptions`                        | `{}`                  | Deflate-specific options                                  |
+
+## How It Works
+
+1. Client sends request with `Accept-Encoding: gzip, deflate, br`
+2. Middleware checks which algorithms are in the `algorithms` config
+3. Selects best match from allowed algorithms (priority: br > gzip > deflate)
+4. If no match, responds with uncompressed data (identity)
+
+### Algorithm Selection Priority
+
+When multiple algorithms are allowed and accepted by the client:
+
+1. **Brotli (br)** - Best compression ratio
+2. **Gzip (gzip)** - Good compression, widely supported
+3. **Deflate (deflate)** - Faster but less efficient
+
+## Comparison with `compression`
+
+| Feature               | `compression` | `xypriss-compression` |
+| --------------------- | ------------- | --------------------- |
+| Algorithm enforcement | No            | Yes                   |
+| TypeScript            | No            | Yes                   |
+| Custom filters        | Yes           | Yes                   |
+| Threshold             | Yes           | Yes                   |
+| Brotli support        | Yes           | Yes                   |
+
+## Use Cases
+
+### Security Compliance
+
+```typescript
+// Only use approved algorithms
+app.use(
+  compression({
+    algorithms: ["br"], // Company policy: Brotli only
+  })
+);
+```
+
+### Performance Optimization
+
+```typescript
+// Prefer speed over compression ratio
+app.use(
+  compression({
+    algorithms: ["deflate"], // Fastest
+    level: 1,
+  })
+);
+```
+
+### Modern Browsers Only
+
+```typescript
+// Serve Brotli to modern browsers, nothing to old ones
+app.use(
+  compression({
+    algorithms: ["br"],
+    filter: (req, res) => {
+      // Fallback to uncompressed for old browsers
+      return req.headers["user-agent"]?.includes("Chrome") || false;
+    },
+  })
+);
+```
+
+## Debugging
+
+Enable debug logs:
+
+```bash
+DEBUG=xypriss:compression node app.js
+```
+
+## License
+
+MIT
+
+## Author
+
+**Nehonix Team**
+
+- Website: [nehonix.com](https://nehonix.com)
+- GitHub: [@Nehonix-Team](https://github.com/Nehonix-Team)
+
+## Credits
+
+Based on [expressjs/compression](https://github.com/expressjs/compression) but with strict algorithm enforcement.
+
+## Links
+
+- [GitHub Repository](https://github.com/Nehonix-Team/xypriss-compression-plugin)
+- [Issue Tracker](https://github.com/Nehonix-Team/xypriss-compression-plugin/issues)
+- [XyPriss Framework](https://github.com/Nehonix-Team/XyPriss)

package/.xypriss-compression-dev/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "xypriss-compression-pluging",
+  "version": "1.0.3",
+  "description": "Custom compression middleware for XyPriss with strict algorithm enforcement",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "compression",
+    "gzip",
+    "deflate",
+    "brotli",
+    "br",
+    "middleware",
+    "express",
+    "xypriss",
+    "http",
+    "stream",
+    "algorithm-enforcement",
+    "typescript"
+  ],
+  "author": {
+    "name": "Nehonix Team",
+    "url": "https://nehonix.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nehonix-Team/xypriss-compression-plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Nehonix-Team/xypriss-compression-plugin/issues"
+  },
+  "homepage": "https://github.com/Nehonix-Team/xypriss-compression-plugin#readme",
+  "dependencies": {
+    "bytes": "^3.1.2",
+    "compressible": "^2.0.18",
+    "debug": "^2.6.9",
+    "on-headers": "^1.1.0",
+    "vary": "^1.1.2"
+  },
+  "devDependencies": {
+    "@types/bytes": "^3.1.4",
+    "@types/compressible": "^2.0.2",
+    "@types/debug": "^4.1.12",
+    "@types/negotiator": "^0.6.4",
+    "@types/node": "^20.0.0",
+    "@types/on-headers": "^1.0.4",
+    "@types/vary": "^1.1.3",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">= 14.0.0"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  }
+}

package/dist/index.d.ts

@@ -8287,42 +8287,6 @@ declare class XyPrissRouter {
     private _matchPathWithPattern;
 }
 
-/**
- * XyPrissJS Smart Routes
- * Intelligent route handlers with automatic optimization, caching, and security
- */
-
-/**
- * Smart route configuration for intelligent caching
- */
-interface SmartRouteConfig {
-    ttl?: number;
-    tags?: string[];
-    strategy?: "always" | "conditional" | "smart" | "never";
-    conditions?: {
-        methods?: string[];
-        statusCodes?: number[];
-        headers?: Record<string, string>;
-        queryParams?: string[];
-    };
-    smart?: {
-        minHits?: number;
-        hitWindow?: number;
-        adaptiveTTL?: boolean;
-    };
-    invalidation?: {
-        onMethods?: string[];
-        onRoutes?: string[];
-        onTags?: string[];
-    };
-}
-/**
- * Create a secure route with maximum protection
- */
-declare function Route(config: Omit<RouteConfig, "security"> & {
-    security?: Partial<RouteConfig["security"]>;
-}): MiddlewareFunction$1;
-
 /**
  * XyPrissJS Cache Factory
  *@version 4.1.8
@@ -9137,5 +9101,5 @@ declare global {
  */
 declare function Router(): XyPrissRouter;
 
-export { ConfigurationManager as CM, ConfigurationManager as Configs, FileUploadAPI as FLA, FileUploadAPI, PerformanceMonitor, Plugin, PluginHookIds, Route, Router, SecurityMiddleware, TrustProxy, Upload, XJsonResponseHandler, MultiServerApp as XyPMS, XyPrissRouter, XyPrissSys, __cfg__, __const__, __sys__, createCircularRefDebugger, createOptimalCache, createSafeJsonMiddleware, createServer, initializeFileUpload, mergeWithDefaults, mergeWithDefaults as mwdef, quickServer, safeJsonStringify, sendSafeJson, setupSafeJson, uploadAny, uploadArray, uploadFields, uploadSingle, xems };
-export type { ArchiveOptions, BatchRenameChange, CacheConfig, FileUploadConfig as FiUpConfig, FileUploadConfig, MonitorSnapshot, MultiServerConfig, NetworkStats, NextFunction, PerformanceConfig, PluginCreator, ProcessInfo, ProcessMonitorSnapshot, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RouteConfig, RouteOptions, SecurityConfig, ServerOptions$1 as ServerOptions, SmartRouteConfig, TrustProxyValue$1 as TrustProxyValue, UltraFastApp, XemsTypes, XyPrisRequest, XyPrisResponse, XyPrissPlugin, XyPrisRequest as XyPrissRequest, XyPrisResponse as XyPrissResponse };
+export { ConfigurationManager as CM, ConfigurationManager as Configs, FileUploadAPI as FLA, FileUploadAPI, PerformanceMonitor, Plugin, PluginHookIds, Router, SecurityMiddleware, TrustProxy, Upload, XJsonResponseHandler, MultiServerApp as XyPMS, XyPrissRouter, XyPrissSys, __cfg__, __const__, __sys__, createCircularRefDebugger, createOptimalCache, createSafeJsonMiddleware, createServer, initializeFileUpload, mergeWithDefaults, mergeWithDefaults as mwdef, quickServer, safeJsonStringify, sendSafeJson, setupSafeJson, uploadAny, uploadArray, uploadFields, uploadSingle, xems };
+export type { ArchiveOptions, BatchRenameChange, CacheConfig, FileUploadConfig as FiUpConfig, FileUploadConfig, MonitorSnapshot, MultiServerConfig, NetworkStats, NextFunction, PerformanceConfig, PluginCreator, ProcessInfo, ProcessMonitorSnapshot, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RouteConfig, RouteOptions, SecurityConfig, ServerOptions$1 as ServerOptions, TrustProxyValue$1 as TrustProxyValue, UltraFastApp, XemsTypes, XyPrisRequest, XyPrisResponse, XyPrissPlugin, XyPrisRequest as XyPrissRequest, XyPrisResponse as XyPrissResponse };

package/dist/shared/logger/DEFAULT_LOGGER_CONFIG.d.ts

@@ -0,0 +1,3 @@
+export type LoggerConfig = NonNullable<ServerOptions["logging"]>;
+export declare const DEFAULT_LOGGER_CONFIG: LoggerConfig;
+//# sourceMappingURL=DEFAULT_LOGGER_CONFIG.d.ts.map

package/dist/shared/logger/DEFAULT_LOGGER_CONFIG.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DEFAULT_LOGGER_CONFIG.d.ts","sourceRoot":"","sources":["../../../shared/logger/DEFAULT_LOGGER_CONFIG.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;AAEjE,eAAO,MAAM,qBAAqB,EAAE,YAgEnC,CAAC"}

package/dist/shared/logger/DEFAULT_LOGGER_CONFIG.js

@@ -0,0 +1,66 @@
+import { DEFAULT_CONSOLE_CONFIG } from "../../src/server/components/fastapi/console/types";
+export const DEFAULT_LOGGER_CONFIG = {
+    enabled: true,
+    level: "info",
+    components: {
+        server: true,
+        cache: true,
+        cluster: true,
+        performance: true,
+        fileWatcher: true,
+        plugins: true,
+        security: true,
+        monitoring: true,
+        routes: true,
+        userApp: true,
+        middleware: true,
+        router: true,
+        typescript: true,
+        acpes: true,
+        other: true,
+        ipc: true,
+        memory: true,
+        lifecycle: true,
+        routing: true,
+        xems: true,
+        console: false, // noisy by default
+    },
+    types: {
+        startup: true,
+        warnings: true,
+        errors: true,
+        performance: true,
+        debug: false,
+        hotReload: true,
+        portSwitching: true,
+        lifecycle: true,
+    },
+    format: {
+        timestamps: true,
+        colors: true,
+        prefix: true,
+        compact: false,
+        includeMemory: false,
+        includeProcessId: false,
+        maxLineLength: 0,
+    },
+    buffer: {
+        enabled: false,
+        maxSize: 1000,
+        flushInterval: 5000,
+        autoFlush: true,
+    },
+    errorHandling: {
+        maxErrorsPerMinute: 100,
+        suppressRepeatedErrors: true,
+        suppressAfterCount: 5,
+        resetSuppressionAfter: 300000,
+    },
+    // Console Interception with Encryption Support
+    consoleInterception: {
+        ...DEFAULT_CONSOLE_CONFIG,
+        enabled: false, // Disabled by default (user can enable when needed)
+        preserveOriginal: true,
+    },
+};
+//# sourceMappingURL=DEFAULT_LOGGER_CONFIG.js.map

package/dist/shared/logger/DEFAULT_LOGGER_CONFIG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DEFAULT_LOGGER_CONFIG.js","sourceRoot":"","sources":["../../../shared/logger/DEFAULT_LOGGER_CONFIG.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAI3F,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IAC/C,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,MAAM;IACb,UAAU,EAAE;QACR,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,KAAK,EAAE,mBAAmB;KACtC;IACD,KAAK,EAAE;QACH,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,IAAI;QACjB,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACJ,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,KAAK;QACd,aAAa,EAAE,KAAK;QACpB,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,CAAC;KACnB;IACD,MAAM,EAAE;QACJ,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE,IAAI;KAClB;IACD,aAAa,EAAE;QACX,kBAAkB,EAAE,GAAG;QACvB,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,CAAC;QACrB,qBAAqB,EAAE,MAAO;KACjC;IACA,+CAA+C;IAC5C,mBAAmB,EAAE;QACjB,GAAG,sBAAsB;QACzB,OAAO,EAAE,KAAK,EAAE,oDAAoD;QACpE,gBAAgB,EAAE,IAAI;KACzB;CAER,CAAC"}

package/dist/shared/logger/DEFAULT_PALETTE.d.ts

@@ -0,0 +1,16 @@
+export declare const DEFAULT_PALETTE: {
+    reset: string;
+    bold: string;
+    dim: string;
+    gray: string;
+    white: string;
+    red: string;
+    brightRed: string;
+    yellow: string;
+    green: string;
+    brightGreen: string;
+    cyan: string;
+    blue: string;
+    magenta: string;
+};
+//# sourceMappingURL=DEFAULT_PALETTE.d.ts.map

package/dist/shared/logger/DEFAULT_PALETTE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DEFAULT_PALETTE.d.ts","sourceRoot":"","sources":["../../../shared/logger/DEFAULT_PALETTE.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;CAc3B,CAAC"}

package/dist/shared/logger/DEFAULT_PALETTE.js

@@ -0,0 +1,16 @@
+export const DEFAULT_PALETTE = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    gray: "\x1b[90m",
+    white: "\x1b[37m",
+    red: "\x1b[31m",
+    brightRed: "\x1b[91m",
+    yellow: "\x1b[33m",
+    green: "\x1b[32m",
+    brightGreen: "\x1b[92m",
+    cyan: "\x1b[36m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+};
+//# sourceMappingURL=DEFAULT_PALETTE.js.map

package/dist/shared/logger/DEFAULT_PALETTE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DEFAULT_PALETTE.js","sourceRoot":"","sources":["../../../shared/logger/DEFAULT_PALETTE.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,UAAU;IACf,SAAS,EAAE,UAAU;IACrB,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,UAAU;IACvB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,UAAU;CACtB,CAAC"}

package/dist/shared/logger/Logger.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Logger.ts
+ * Centralized logger for FastApi.ts — structured, typed, and console-friendly.
+ *
+ * Output format:  {gray timestamp} {color}[COMPONENT]{/} {color}message{/}
+ *
+ * Color logic:
+ *  - error   → bright red   (level always wins)
+ *  - warn    → yellow       (level always wins)
+ *  - debug   → magenta      (level always wins)
+ *  - verbose → gray         (level always wins)
+ *  - info / startup / perf / etc. → component identity color
+ */
+import type { LogLevel, LogComponent, LogType } from "../types";
+import { LoggerConfig } from "./DEFAULT_LOGGER_CONFIG";
+export declare class Logger {
+    private static instance;
+    static getInstance(config?: LoggerConfig): Logger;
+    private config;
+    private buffer;
+    private flushTimer?;
+    private isDisposed;
+    private palette;
+    private compColors;
+    private levelColors;
+    private logQueue;
+    private isProcessingQueue;
+    private errorCount;
+    private lastErrorTime;
+    private suppressedComponents;
+    constructor(config?: LoggerConfig);
+    private applyColors;
+    error(component: LogComponent, message: string, ...args: any[]): void;
+    warn(component: LogComponent, message: string, ...args: any[]): void;
+    info(component: LogComponent, message: string, ...args: any[]): void;
+    debug(component: LogComponent, message: string, ...args: any[]): void;
+    verbose(component: LogComponent, message: string, ...args: any[]): void;
+    startup(component: LogComponent, message: string, ...args: any[]): void;
+    performance(component: LogComponent, message: string, ...args: any[]): void;
+    hotReload(component: LogComponent, message: string, ...args: any[]): void;
+    portSwitching(component: LogComponent, message: string, ...args: any[]): void;
+    success(component: LogComponent, message: string, ...args: any[]): void;
+    securityWarning(message: string, ...args: any[]): void;
+    updateConfig(config: LoggerConfig): void;
+    getConfig(): LoggerConfig;
+    getLevel(): LogLevel;
+    isEnabled(): boolean;
+    isComponentEnabled(component: LogComponent): boolean;
+    isTypeEnabled(type: LogType): boolean;
+    getStats(): {
+        errorCount: number;
+        lastErrorTime: number;
+        suppressedComponents: ("middleware" | "server" | "cache" | "cluster" | "performance" | "fileWatcher" | "plugins" | "security" | "monitoring" | "routes" | "userApp" | "typescript" | "console" | "other" | "router" | "acpes" | "ipc" | "memory" | "lifecycle" | "routing" | "xems")[];
+        bufferSize: number;
+        queueSize: number;
+    };
+    clearSuppression(): void;
+    flush(): void;
+    dispose(): void;
+    /** Create a scoped child logger inheriting (and optionally overriding) config. */
+    child(_component: LogComponent, config?: Partial<LoggerConfig>): Logger;
+    private log;
+    private drainQueue;
+    private shouldLog;
+    private shouldSuppressError;
+    private writeEntry;
+    /**
+     * Produces a log line:
+     *
+     *   {gray}HH:MM:SS.mmm{/} {color}[COMPONENT]{/} {color}message{/}
+     *
+     * Color priority:
+     *   1. Level color  — error=brightRed, warn=yellow, debug=magenta, verbose=gray
+     *   2. Component color — each component has its own identity color (for info-class)
+     *
+     * Tag and message always share the same color so they read as one visual unit.
+     */
+    private formatEntry;
+    /** Human-readable uppercase label for a component. */
+    private componentLabel;
+    private truncate;
+    private readMemoryMB;
+    private readProcessId;
+    /** Bypass all filters — used only for logger-internal failures. */
+    private emergencyLog;
+    private initBuffer;
+    private initErrorHandling;
+    private deepMerge;
+}
+/** Shared singleton — ready to use immediately. */
+export declare const logger: Logger;
+/** Configure and return the singleton logger. */
+export declare function initializeLogger(config?: LoggerConfig): Logger;
+/** Flush + dispose the singleton — call on graceful shutdown. */
+export declare function cleanupLogger(): void;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/shared/logger/Logger.d.ts.map

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