xypriss 9.11.13 → 9.12.0

package/dist/src/plugins/types/PluginTypes.d.ts

@@ -0,0 +1,312 @@
+/**
+ * Plugin System Types
+ */
+import type { Request, Response, NextFunction, XyPrissApp, ServerOptions } from "../../types/types";
+import type { InterceptedConsoleCall } from "../../server/components/fastapi/console/types";
+/**
+ * Plugin execution phases for optimal performance routing
+ */
+export declare enum PluginType {
+    PRE_REQUEST = "pre-request",// <0.5ms - Request preprocessing, parsing optimization
+    SECURITY = "security",// <2ms - Authentication, authorization, validation
+    NETWORK = "network",// <1ms - Network operations, connection management, proxy, compression
+    CACHE = "cache",// <0.5ms - Cache operations, hit/miss handling
+    PERFORMANCE = "performance",// <0.3ms - Metrics collection, monitoring
+    POST_RESPONSE = "post-response",// <0.2ms - Cleanup, logging, analytics
+    MIDDLEWARE = "middleware",// <1ms - Custom XyPriss middleware integration
+    NATIVE = "native"
+}
+/**
+ * Plugin execution priority for performance optimization
+ */
+export declare enum PluginPriority {
+    CRITICAL = 0,// High-performance execution, <0.1ms
+    HIGH = 1,// High priority, <0.5ms
+    NORMAL = 2,// Standard priority, <1ms
+    LOW = 3,// Low priority, <2ms
+    BACKGROUND = 4
+}
+export interface XyPrissServer {
+    app: XyPrissApp;
+    options?: ServerOptions;
+    [key: string]: any;
+}
+/**
+ * Restricted XyPrissApp for plugins.
+ * Only allows HTTP methods, middleware registration, and — conditionally — server configs.
+ */
+export interface PluginXyPrissApp {
+    get(path: string, ...handlers: any[]): void;
+    post(path: string, ...handlers: any[]): void;
+    put(path: string, ...handlers: any[]): void;
+    delete(path: string, ...handlers: any[]): void;
+    patch(path: string, ...handlers: any[]): void;
+    options(path: string, ...handlers: any[]): void;
+    head(path: string, ...handlers: any[]): void;
+    connect(path: string, ...handlers: any[]): void;
+    trace(path: string, ...handlers: any[]): void;
+    all(path: string, ...handlers: any[]): void;
+    use(...args: any[]): void;
+    /**
+     * The full server configuration options passed to `createServer()` by the host application.
+     *
+     * This property is **permission-gated** at runtime. The security facade will return
+     * `undefined` unless the plugin has been explicitly granted the
+     * `XHS.PERM.SECURITY.CONFIGS` permission in the host project's `allowedHooks`.
+     *
+     * Wildcards (`"*"`) do NOT grant this permission — it must be declared explicitly.
+     *
+     * Typical use cases:
+     *  - Reading the server port or host for building absolute URLs in generated docs.
+     *  - Detecting the runtime environment (`env: "production" | "development"`) to
+     *    adapt plugin behavior without hardcoding values.
+     *  - Accessing feature flags passed through custom server options.
+     *
+     * @permission XHS.PERM.SECURITY.CONFIGS
+     *
+     * @example
+     * // Inside onAuxiliaryServerDeploy or onServerStart:
+     * const port = server.app.configs?.server?.port ?? 3000;
+     * const env  = server.app.configs?.env ?? "development";
+     */
+    configs?: ServerOptions;
+}
+/**
+ * Restricted XyPrissServer for plugins.
+ *
+ * This is the facade object injected as the `server` argument in lifecycle hooks
+ * such as `onServerStart`, `onServerReady`, and `onAuxiliaryServerDeploy`.
+ * It intentionally exposes only a safe subset of the real server's capabilities.
+ *
+ * The engine's security layer intercepts every property access on `server.app`
+ * and enforces per-plugin permission checks before delegating to the real
+ * underlying application instance.
+ */
+export interface PluginServer {
+    /**
+     * The restricted application facade.
+     *
+     * Provides access to HTTP method registrars (`get`, `post`, etc.), `use()`,
+     * and the conditional `configs` property. Any attempt to access properties
+     * not in this interface will be silently blocked by the security layer.
+     */
+    app: PluginXyPrissApp;
+}
+export interface PluginStats {
+    name: string;
+    version: string;
+    description?: string;
+    enabled: boolean;
+    permissions: {
+        allowedHooks: string[] | "*";
+        deniedHooks: string[];
+        policy: "allow" | "deny";
+    };
+    uid?: string;
+    dependencies: string[];
+}
+export interface PluginManagement {
+    getStats: () => PluginStats[];
+    setPermission: (pluginName: string, hookId: string, allowed: boolean, by?: string) => void;
+    toggle: (pluginName: string, enabled: boolean) => void;
+}
+export interface OpsServerManager {
+    /**
+     * Deploys a fully configured independent XyPriss auxiliary server.
+     * Use this for internal admin dashboards, metric scrapers, or documentation servers.
+     */
+    createAuxiliaryServer: (options: ServerOptions) => XyPrissApp;
+    /**
+     * Returns the global route registry for documentation generation.
+     */
+    getRouteRegistry: () => any[];
+}
+export interface XyPrissPlugin {
+    name: string;
+    version: string;
+    type?: string;
+    description: string;
+    /**
+     * @internal - Captured project root of the plugin.
+     * Used for contract security verification.
+     */
+    __root__?: string;
+    /**
+     * @internal - Unique technical identifier for the plugin instance.
+     * Generated at registration based on fingerprint.
+     */
+    uid?: string;
+    /**
+     * @internal - Metadata fingerprint used for duplicate discovery and unique identification.
+     */
+    fingerprint?: string;
+    dependencies?: string[];
+    onRegister?(error?: Error | null): void | Promise<void>;
+    onServerStart?(server: PluginServer): void | Promise<void>;
+    onServerReady?(server: PluginServer): void | Promise<void>;
+    onServerStop?(server: PluginServer): void | Promise<void>;
+    onRequest?(req: Request, res: Response, next: NextFunction): void | Promise<void>;
+    onResponse?(req: Request, res: Response): void | Promise<void>;
+    onError?(error: Error, req: Request, res: Response, next?: NextFunction): void | Promise<void>;
+    /**
+     * Hook triggered when a security attack or problem is detected
+     */
+    onSecurityAttack?(attackData: any, req: Request, res: Response): void | Promise<void>;
+    /**
+     * Hook triggered to report the response time of a request
+     */
+    onResponseTime?(responseTime: number, req: Request, res: Response): void | Promise<void>;
+    /**
+     * Hook triggered when a route generates a 500 error
+     */
+    onRouteError?(error: Error, req: Request, res: Response): void | Promise<void>;
+    /**
+     * Hook triggered when a rate limit is reached
+     */
+    onRateLimit?(limitData: any, req: Request, res: Response): void | Promise<void>;
+    /**
+     * Hook triggered when a console log is intercepted by the system.
+     *
+     * This hook allows plugins to monitor, analyze, or redirect all console output
+     * (log, info, warn, error, debug, etc.) across the entire application.
+     *
+     * @param log - The intercepted console call data including method, arguments, and metadata.
+     * @permission XHS.PERM.LOGGING.CONSOLE_INTERCEPT - Required to receive log data.
+     * @performance This hook is executed synchronously; preserve performance by avoiding heavy tasks.
+     * @security Sensitive data may be present in logs; handle with extreme care.
+     * @default Disabled by default for security.
+     */
+    onConsoleIntercept?(log: InterceptedConsoleCall): void | Promise<void>;
+    registerRoutes?(app: XyPrissApp): void;
+    middleware?: any | any[];
+    middlewarePriority?: "first" | "normal" | "last";
+    /**
+     * Hook for plugin management
+     * Only called if the plugin has MANAGE_PLUGINS permission
+     */
+    managePlugins?(manager: PluginManagement): void | Promise<void>;
+    /**
+     * Advanced Ops Hook — Deploy an Independent Auxiliary Server
+     *
+     * This hook enables a plugin to spawn a fully isolated XyPriss server instance
+     * on a separate port, completely independent from the main application server.
+     * It is the recommended pattern for deploying internal-only tooling such as:
+     *
+     *  - Admin dashboards and back-office UIs
+     *  - API documentation servers (e.g., Swagger, Redoc)
+     *  - Internal metrics scrapers (e.g., Prometheus exposition endpoint)
+     *  - Dedicated WebSocket or SSE servers
+     *  - Debug/introspection interfaces (development only)
+     *
+     * --- Execution Context ---
+     * This hook is called once during the server initialization phase, after
+     * `onServerStart` has fired on all plugins. The auxiliary server created here
+     * operates as a completely separate process listener and does NOT share
+     * middleware, routes, or request lifecycle with the main server.
+     *
+     * --- Security Model ---
+     * This is a **privileged Ops hook**. It will not be called unless the plugin
+     * has been explicitly granted the `XHS.PERM.OPS.AUXILIARY_SERVER` permission
+     * in the host project's configuration. Attempting to use it without the
+     * required permission will result in a silent no-op (the engine will block
+     * the hook invocation before your code is reached).
+     *
+     * The `server` argument is a restricted facade of the main XyPrissServer
+     * instance (a `PluginServer`). It exposes only the HTTP method registrars
+     * (`get`, `post`, etc.) and `use()`, scoped to your plugin's namespace.
+     * Direct access to `server.app` internals or low-level engine properties
+     * is blocked by the security layer.
+     *
+     * --- Parameters ---
+     * @param ops - The `OpsServerManager` context. Provides two capabilities:
+     *
+     *   `ops.createAuxiliaryServer(options: ServerOptions): XyPrissApp`
+     *   Spawns and returns a new, fully configured XyPriss app instance bound
+     *   to the port specified in `options.server.port`. All standard XyPriss
+     *   features (routing, middleware, logging) are available on this instance.
+     *   The performance and plugin subsystems are disabled by default to avoid
+     *   recursive initialization.
+     *
+     *   `ops.getRouteRegistry(): RouteEntry[]`
+     *   Returns a snapshot of all routes registered on the MAIN server at the
+     *   time of the call. Useful for generating live documentation or dashboards
+     *   that reflect the host application's actual API surface.
+     *
+     * @param server - A restricted facade of the main XyPrissServer. Exposes
+     *   only the HTTP methods and `use()` of the main `app` instance, scoped
+     *   to this plugin's namespace. Use this to cross-register a route on the
+     *   main server (e.g., a redirect from `/docs` on the main port to the
+     *   auxiliary docs port) without full access to internal engine state.
+     *
+     * @permission XHS.PERM.OPS.AUXILIARY_SERVER
+     *   Must be declared in `xfpm.permissions` inside `package.json` AND
+     *   explicitly listed in `allowedHooks` in the host project's plugin
+     *   configuration. Wildcards (`"*"`) do NOT grant this privileged hook.
+     *
+     * @example
+     * // Use case 1: Spawn a dedicated Swagger documentation server
+     * async onAuxiliaryServerDeploy(ops, server) {
+     *     const routes = ops.getRouteRegistry();
+     *     const openApiSpec = generateOpenApiSpec(routes);
+     *
+     *     const docsApp = ops.createAuxiliaryServer({
+     *         server: { port: 9001, host: "127.0.0.1" },
+     *         logging: { enabled: true, level: "warn" },
+     *     });
+     *
+     *     docsApp.get("/openapi.json", (req, res) => {
+     *         res.json(openApiSpec);
+     *     });
+     *
+     *     docsApp.get("/", (req, res) => {
+     *         res.send(renderSwaggerUI("/openapi.json"));
+     *     });
+     *
+     *     // Optionally register a redirect on the main server (scoped to plugin namespace)
+     *     server.app.get("/my-plugin/docs", (req, res) => {
+     *         res.redirect("http://localhost:9001");
+     *     });
+     * }
+     *
+     * @example
+     * // Use case 2: Internal Prometheus metrics endpoint (never exposed publicly)
+     * async onAuxiliaryServerDeploy(ops, _server) {
+     *     const metricsApp = ops.createAuxiliaryServer({
+     *         server: { port: 9090, host: "127.0.0.1" },
+     *         logging: { enabled: false },
+     *     });
+     *
+     *     metricsApp.get("/metrics", (req, res) => {
+     *         res.setHeader("Content-Type", "text/plain; version=0.0.4");
+     *         res.send(collectMetrics());
+     *     });
+     * }
+     */
+    onAuxiliaryServerDeploy?(ops: OpsServerManager, server: PluginServer): void | Promise<void>;
+}
+export type PluginCreator = (config?: any) => XyPrissPlugin;
+export interface PluginConfig {
+    connection?: any;
+    register?: Array<XyPrissPlugin | PluginCreator>;
+    /** Server maintenance plugin configuration */
+    serverMaintenance?: {
+        enabled?: boolean;
+        checkInterval?: number;
+        errorThreshold?: number;
+        memoryThreshold?: number;
+        responseTimeThreshold?: number;
+        logRetentionDays?: number;
+        maxLogFileSize?: number;
+        autoCleanup?: boolean;
+        autoRestart?: boolean;
+        onIssueDetected?: (issue: any) => void;
+        onMaintenanceComplete?: (actions: string[]) => void;
+    };
+    /**
+     * Allow lifecycle hooks (onServerStart, onServerReady, onServerStop) to execute
+     * by default even if not explicitly whitelisted in allowedHooks.
+     * @default false (Zero-Trust)
+     */
+    allowLifecycleByDefault?: boolean;
+}
+//# sourceMappingURL=PluginTypes.d.ts.map

package/dist/src/plugins/types/PluginTypes.d.ts.map

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

package/dist/src/plugins/types/PluginTypes.js

@@ -0,0 +1,30 @@
+/**
+ * Plugin System Types
+ */
+// ===== CORE PLUGIN TYPES =====
+/**
+ * Plugin execution phases for optimal performance routing
+ */
+export var PluginType;
+(function (PluginType) {
+    PluginType["PRE_REQUEST"] = "pre-request";
+    PluginType["SECURITY"] = "security";
+    PluginType["NETWORK"] = "network";
+    PluginType["CACHE"] = "cache";
+    PluginType["PERFORMANCE"] = "performance";
+    PluginType["POST_RESPONSE"] = "post-response";
+    PluginType["MIDDLEWARE"] = "middleware";
+    PluginType["NATIVE"] = "native";
+})(PluginType || (PluginType = {}));
+/**
+ * Plugin execution priority for performance optimization
+ */
+export var PluginPriority;
+(function (PluginPriority) {
+    PluginPriority[PluginPriority["CRITICAL"] = 0] = "CRITICAL";
+    PluginPriority[PluginPriority["HIGH"] = 1] = "HIGH";
+    PluginPriority[PluginPriority["NORMAL"] = 2] = "NORMAL";
+    PluginPriority[PluginPriority["LOW"] = 3] = "LOW";
+    PluginPriority[PluginPriority["BACKGROUND"] = 4] = "BACKGROUND";
+})(PluginPriority || (PluginPriority = {}));
+//# sourceMappingURL=PluginTypes.js.map

package/dist/src/plugins/types/PluginTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginTypes.js","sourceRoot":"","sources":["../../../../src/plugins/types/PluginTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,gCAAgC;AAEhC;;GAEG;AACH,MAAM,CAAN,IAAY,UASX;AATD,WAAY,UAAU;IAClB,yCAA2B,CAAA;IAC3B,mCAAqB,CAAA;IACrB,iCAAmB,CAAA;IACnB,6BAAe,CAAA;IACf,yCAA2B,CAAA;IAC3B,6CAA+B,CAAA;IAC/B,uCAAyB,CAAA;IACzB,+BAAiB,CAAA;AACrB,CAAC,EATW,UAAU,KAAV,UAAU,QASrB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACtB,2DAAY,CAAA;IACZ,mDAAQ,CAAA;IACR,uDAAU,CAAA;IACV,iDAAO,CAAA;IACP,+DAAc,CAAA;AAClB,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB"}

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

@@ -0,0 +1,79 @@
+export interface RouteStats {
+    path: string;
+    method: string;
+    hitCount: number;
+    totalResponseTime: number;
+    averageResponseTime: number;
+    lastAccessed: Date;
+    errorCount: number;
+    cacheHits: number;
+    cacheMisses: number;
+    popularity: number;
+}
+export interface OptimizationRule {
+    pattern: string;
+    minHits: number;
+    maxResponseTime: number;
+    cacheStrategy: "aggressive" | "moderate" | "conservative";
+    preloadEnabled?: boolean;
+}
+export interface RouteOptimizationConfig {
+    enabled?: boolean;
+    analysisInterval?: number;
+    optimizationThreshold?: number;
+    popularityWindow?: number;
+    maxTrackedRoutes?: number;
+    autoOptimization?: boolean;
+    customRules?: OptimizationRule[];
+    onOptimization?: (route: string, optimization: string) => void;
+    onAnalysis?: (stats: RouteStats[]) => void;
+}
+export interface PluginManagerConfig {
+    routeOptimization?: RouteOptimizationConfig;
+    serverMaintenance?: MaintenanceConfig;
+    customPlugins?: Array<{
+        name: string;
+        plugin: any;
+        config?: any;
+    }>;
+}
+export interface MaintenanceIssue {
+    type: "error" | "warning" | "info";
+    category: "memory" | "performance" | "logs" | "errors" | "resources";
+    message: string;
+    severity: number;
+    timestamp: Date;
+    details: any;
+    resolved: boolean;
+}
+export interface HealthMetrics {
+    memoryUsage: {
+        used: number;
+        total: number;
+        percentage: number;
+        trend: "increasing" | "stable" | "decreasing";
+    };
+    cpuUsage: number;
+    errorRate: number;
+    responseTime: {
+        average: number;
+        p95: number;
+        trend: "improving" | "stable" | "degrading";
+    };
+    activeConnections: number;
+    uptime: number;
+}
+export interface MaintenanceConfig {
+    enabled?: boolean;
+    checkInterval?: number;
+    errorThreshold?: number;
+    memoryThreshold?: number;
+    responseTimeThreshold?: number;
+    logRetentionDays?: number;
+    maxLogFileSize?: number;
+    autoCleanup?: boolean;
+    autoRestart?: boolean;
+    onIssueDetected?: (issue: MaintenanceIssue) => void;
+    onMaintenanceComplete?: (actions: string[]) => void;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

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

package/dist/src/quick-start.d.ts

@@ -0,0 +1,9 @@
+/**
+ * XyPrissJS Quick Start
+ * Pre-configured server instances for rapid development (tests with limited configs)
+ */
+/**
+ * Quick development server with sensible defaults
+ */
+export declare function quickServer(port?: number): import("./types/XyApp.type").XyApp;
+//# sourceMappingURL=quick-start.d.ts.map

package/dist/src/quick-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-start.d.ts","sourceRoot":"","sources":["../../src/quick-start.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAa,sCAiB9C"}

package/dist/src/quick-start.js

@@ -0,0 +1,26 @@
+/**
+ * XyPrissJS Quick Start
+ * Pre-configured server instances for rapid development (tests with limited configs)
+ */
+import { createServer } from "./server/ServerFactory";
+/**
+ * Quick development server with sensible defaults
+ */
+export function quickServer(port = 8272) {
+    const config = {
+        env: "test",
+        server: {
+            port,
+            host: "localhost",
+        },
+        cluster: {
+            enabled: false,
+        },
+        cache: {
+            enabled: true,
+            strategy: "memory",
+        },
+    };
+    return createServer(config);
+}
+//# sourceMappingURL=quick-start.js.map

package/dist/src/quick-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-start.js","sourceRoot":"","sources":["../../src/quick-start.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAiB,MAAM,wBAAwB,CAAC;AAErE;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,IAAI;IAC3C,MAAM,MAAM,GAAkB;QAC1B,GAAG,EAAE,MAAM;QACX,MAAM,EAAE;YACJ,IAAI;YACJ,IAAI,EAAE,WAAW;SACpB;QACD,OAAO,EAAE;YACL,OAAO,EAAE,KAAK;SACjB;QACD,KAAK,EAAE;YACH,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,QAAQ;SACrB;KACJ,CAAC;IAEF,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/schemas/plugingSchema.d.ts

@@ -0,0 +1,18 @@
+declare const schm: import("reliant-type").InterfaceSchema<{
+    readonly name: string;
+    readonly version: any;
+} & {}>;
+export declare function validatePlgInput(d: typeof schm.types): string | ({
+    readonly name: string;
+    readonly version: any;
+} & {}) | undefined;
+export {};
+/**
+ * // const schm = Interface({
+//     name: "string(/^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$/)",
+//     version: "semver",
+// });
+
+ça c'est un bug qu'il faudrait réporter au créateur de reliant-type
+ */
+//# sourceMappingURL=plugingSchema.d.ts.map

package/dist/src/schemas/plugingSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugingSchema.d.ts","sourceRoot":"","sources":["../../../src/schemas/plugingSchema.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,IAAI;;;OAGR,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,KAAK;;;oBA2BpD;;AAED;;;;;;;GAOG"}

package/dist/src/schemas/plugingSchema.js

@@ -0,0 +1,40 @@
+import { Interface } from "reliant-type";
+import { OFFICIAL_PLUGINS } from "../plugins/const/OFFICIAL_PLUGINS";
+const schm = Interface({
+    name: "string", // We will manually validate the strict regex or whitelist
+    version: "semver",
+});
+export function validatePlgInput(d) {
+    try {
+        // First check if it's an official whitelisted plugin
+        const isOfficial = OFFICIAL_PLUGINS.includes(d.name);
+        // If not official, enforce strict alphanumeric/hyphen rules
+        if (!isOfficial) {
+            if (!/^[a-zA-Z0-9-]+$/.test(d.name)) {
+                return `Invalid plugin name: "${d.name}". Only alphanumeric characters and hyphens are allowed. The official '@xypriss/' prefix is strictly reserved for verified internal modules.`;
+            }
+        }
+        const vldt = schm.safeParse(d);
+        if (!vldt.success) {
+            const firstError = vldt.errors[0];
+            const field = firstError.path[0];
+            if (field === "version" && firstError.code === "SEMVER_INVALID") {
+                return `Invalid plugin version: "${d.version}". Version must be a valid semver (e.g., 1.0.0).`;
+            }
+            return firstError.message;
+        }
+        return vldt.data;
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * // const schm = Interface({
+//     name: "string(/^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$/)",
+//     version: "semver",
+// });
+
+ça c'est un bug qu'il faudrait réporter au créateur de reliant-type
+ */
+//# sourceMappingURL=plugingSchema.js.map

package/dist/src/schemas/plugingSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugingSchema.js","sourceRoot":"","sources":["../../../src/schemas/plugingSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,MAAM,IAAI,GAAG,SAAS,CAAC;IACnB,IAAI,EAAE,QAAQ,EAAE,0DAA0D;IAC1E,OAAO,EAAE,QAAQ;CACpB,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,CAAoB;IACjD,IAAI,CAAC;QACD,qDAAqD;QACrD,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAErD,4DAA4D;QAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,OAAO,yBAAyB,CAAC,CAAC,IAAI,8IAA8I,CAAC;YACzL,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEjC,IAAI,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBAC9D,OAAO,4BAA4B,CAAC,CAAC,OAAO,kDAAkD,CAAC;YACnG,CAAC;YAED,OAAO,UAAU,CAAC,OAAO,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;;;;;GAOG"}

package/dist/src/server/FastServer/ComponentManager.d.ts

@@ -0,0 +1,30 @@
+import { Logger } from "../../shared/logger/Logger";
+import { XyPrissApp, ServerOptions } from "../../types/types";
+import { CacheManager } from "../components/fastapi/CacheManager";
+import { XyPluginManager as PluginManager } from "../../plugins/core/XPluginManager";
+import { WorkerPoolComponent } from "../components/fastapi/WorkerPoolComponent";
+import { FileUploadManager } from "../components/fastapi/upload/FileUploadManager";
+import { XyLifecycleManager } from "../core/XyLifecycleManager";
+import { RouteManager } from "../components/fastapi/RouteManager";
+import { ConsoleInterceptor } from "../components/fastapi/console/ConsoleInterceptor";
+export declare class ComponentManager {
+    private app;
+    private logger;
+    private options;
+    private lifecycleManager;
+    private refs;
+    constructor(app: XyPrissApp, logger: Logger, options: ServerOptions, lifecycleManager: XyLifecycleManager, refs: {
+        cacheManager: CacheManager;
+        pluginManager: PluginManager;
+        workerPoolComponent: WorkerPoolComponent;
+        fileUploadManager: FileUploadManager;
+        routeManager: RouteManager;
+        consoleInterceptor: ConsoleInterceptor;
+    });
+    initializeComponentsAsync(): Promise<void>;
+    private initializeCache;
+    private initializePlugins;
+    private initializeWorkerPool;
+    private initializeDependentComponents;
+}
+//# sourceMappingURL=ComponentManager.d.ts.map

package/dist/src/server/FastServer/ComponentManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentManager.d.ts","sourceRoot":"","sources":["../../../../src/server/FastServer/ComponentManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,eAAe,IAAI,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAErF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AAGtF,qBAAa,gBAAgB;IAErB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,IAAI;gBAJJ,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,kBAAkB,EACpC,IAAI,EAAE;QACV,YAAY,EAAE,YAAY,CAAC;QAC3B,aAAa,EAAE,aAAa,CAAC;QAE7B,mBAAmB,EAAE,mBAAmB,CAAC;QACzC,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,YAAY,EAAE,YAAY,CAAC;QAE3B,kBAAkB,EAAE,kBAAkB,CAAC;KAC1C;IAGQ,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;YAmBzC,eAAe;YAWf,iBAAiB;YAIjB,oBAAoB;YAmBpB,6BAA6B;CAyD9C"}