@qwickapps/server 1.0.0

package/dist/core/gateway.js

@@ -0,0 +1,270 @@
+/**
+ * Gateway Server for @qwickapps/server
+ *
+ * Provides a production-ready gateway pattern that:
+ * 1. Serves the control panel UI (always responsive)
+ * 2. Proxies API requests to an internal service
+ * 3. Provides health and diagnostics endpoints
+ *
+ * Architecture:
+ *   Internet → Gateway (GATEWAY_PORT, public) → Service (SERVICE_PORT, internal)
+ *
+ * The gateway is always responsive even if the internal service is down,
+ * allowing diagnostics and error visibility.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { createControlPanel } from './control-panel.js';
+import { initializeLogging, getControlPanelLogger } from './logging.js';
+import { createProxyMiddleware } from 'http-proxy-middleware';
+import { randomBytes } from 'crypto';
+import express from 'express';
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+/**
+ * Basic auth middleware for gateway protection (control panel only)
+ * - Skips localhost requests
+ * - Skips API routes (/api/v1/*) - they have their own service auth
+ * - Skips health endpoints - these should be public
+ * - Requires valid credentials for non-localhost control panel access
+ */
+function createBasicAuthMiddleware(username, password, apiPaths) {
+    const expectedAuth = `Basic ${Buffer.from(`${username}:${password}`).toString('base64')}`;
+    return (req, res, next) => {
+        const path = req.path;
+        // Skip auth for API routes - they use their own authentication
+        for (const apiPath of apiPaths) {
+            if (path.startsWith(apiPath)) {
+                return next();
+            }
+        }
+        // Skip auth for health endpoints - these should be publicly accessible
+        if (path === '/health' || path === '/api/health') {
+            return next();
+        }
+        // Allow localhost without auth
+        const remoteAddress = req.ip || req.socket?.remoteAddress || '';
+        const host = req.hostname || req.headers.host || '';
+        const isLocalhost = host === 'localhost' ||
+            host === '127.0.0.1' ||
+            host.startsWith('localhost:') ||
+            host.startsWith('127.0.0.1:') ||
+            remoteAddress === '127.0.0.1' ||
+            remoteAddress === '::1' ||
+            remoteAddress === '::ffff:127.0.0.1';
+        if (isLocalhost) {
+            return next();
+        }
+        // Check for valid basic auth
+        const authHeader = req.headers.authorization;
+        if (authHeader === expectedAuth) {
+            return next();
+        }
+        // Request authentication
+        res.setHeader('WWW-Authenticate', 'Basic realm="Control Panel"');
+        res.status(401).json({
+            error: 'Unauthorized',
+            message: 'Authentication required.',
+        });
+    };
+}
+/**
+ * Create a gateway that proxies to an internal service
+ *
+ * @param config - Gateway configuration
+ * @param serviceFactory - Factory function to create the internal service
+ * @returns Gateway instance
+ *
+ * @example
+ * ```typescript
+ * import { createGateway } from '@qwickapps/server';
+ *
+ * const gateway = createGateway(
+ *   {
+ *     productName: 'My Service',
+ *     gatewayPort: 3101,
+ *     servicePort: 3100,
+ *   },
+ *   async (port) => {
+ *     const app = createMyApp();
+ *     const server = app.listen(port);
+ *     return {
+ *       app,
+ *       server,
+ *       shutdown: async () => { server.close(); },
+ *     };
+ *   }
+ * );
+ *
+ * await gateway.start();
+ * ```
+ */
+export function createGateway(config, serviceFactory) {
+    // Initialize logging subsystem first
+    const loggingSubsystem = initializeLogging({
+        namespace: config.productName,
+        ...config.logging,
+    });
+    // Use provided logger or get one from the logging subsystem
+    const logger = config.logger || getControlPanelLogger('Gateway');
+    const gatewayPort = config.gatewayPort || parseInt(process.env.GATEWAY_PORT || process.env.PORT || '3101', 10);
+    const servicePort = config.servicePort || parseInt(process.env.SERVICE_PORT || '3100', 10);
+    const nodeEnv = process.env.NODE_ENV || 'development';
+    // Auth configuration
+    const authMode = config.authMode || 'auto';
+    const basicAuthUser = config.basicAuthUser || process.env.BASIC_AUTH_USER || 'admin';
+    const providedPassword = config.basicAuthPassword || process.env.BASIC_AUTH_PASSWORD;
+    const basicAuthPassword = providedPassword || (authMode === 'auto' ? randomBytes(16).toString('base64url') : '');
+    const isPasswordAutoGenerated = !providedPassword && authMode === 'auto';
+    // API paths to proxy
+    const proxyPaths = config.proxyPaths || ['/api/v1'];
+    let service = null;
+    // Create control panel
+    const controlPanel = createControlPanel({
+        config: {
+            productName: config.productName,
+            port: gatewayPort,
+            version: config.version || process.env.npm_package_version || '1.0.0',
+            branding: config.branding,
+            cors: config.corsOrigins ? { origins: config.corsOrigins } : undefined,
+            // Skip body parsing for proxied paths
+            skipBodyParserPaths: [...proxyPaths, '/health'],
+            // Disable built-in dashboard if custom UI is provided
+            disableDashboard: !!config.customUiPath,
+            links: config.links,
+        },
+        plugins: config.plugins || [],
+        logger,
+    });
+    // Add basic auth middleware if enabled
+    if (authMode === 'basic' || authMode === 'auto') {
+        controlPanel.app.use(createBasicAuthMiddleware(basicAuthUser, basicAuthPassword, proxyPaths));
+    }
+    // Setup proxy middleware for API paths
+    const setupProxyMiddleware = () => {
+        const target = `http://localhost:${servicePort}`;
+        // Proxy each API path
+        for (const apiPath of proxyPaths) {
+            const proxyOptions = {
+                target,
+                changeOrigin: false,
+                pathFilter: `${apiPath}/**`,
+                on: {
+                    error: (err, _req, res) => {
+                        logger.error('Proxy error', { error: err.message, path: apiPath });
+                        if (res && 'writeHead' in res && !res.headersSent) {
+                            res.writeHead(503, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify({
+                                error: 'Service Unavailable',
+                                message: 'The service is currently unavailable. Please try again later.',
+                                details: nodeEnv === 'development' ? err.message : undefined,
+                            }));
+                        }
+                    },
+                },
+            };
+            controlPanel.app.use(createProxyMiddleware(proxyOptions));
+        }
+        // Proxy /health endpoint to internal service
+        const healthProxyOptions = {
+            target,
+            changeOrigin: false,
+            pathFilter: '/health',
+            on: {
+                error: (_err, _req, res) => {
+                    if (res && 'writeHead' in res && !res.headersSent) {
+                        res.writeHead(503, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({
+                            status: 'unhealthy',
+                            error: 'Service unavailable',
+                            gateway: 'healthy',
+                        }));
+                    }
+                },
+            },
+        };
+        controlPanel.app.use(createProxyMiddleware(healthProxyOptions));
+    };
+    // Serve custom React UI if provided
+    const setupCustomUI = () => {
+        if (config.customUiPath && existsSync(config.customUiPath)) {
+            logger.info(`Serving custom UI from ${config.customUiPath}`);
+            controlPanel.app.use(express.static(config.customUiPath));
+            // SPA fallback
+            controlPanel.app.get('*', (req, res, next) => {
+                if (req.path.startsWith('/api/') || req.path === '/api') {
+                    return next();
+                }
+                res.sendFile(resolve(config.customUiPath, 'index.html'));
+            });
+        }
+    };
+    const start = async () => {
+        logger.info('Starting gateway...');
+        // 1. Start internal service
+        logger.info(`Starting internal service on port ${servicePort}...`);
+        service = await serviceFactory(servicePort);
+        logger.info(`Internal service started on port ${servicePort}`);
+        // 2. Setup proxy middleware (after service is started)
+        setupProxyMiddleware();
+        // 3. Setup custom UI (after proxy middleware)
+        setupCustomUI();
+        // 4. Start control panel gateway
+        await controlPanel.start();
+        // Log startup info
+        logger.info('');
+        logger.info('========================================');
+        logger.info(`  ${config.productName} Gateway`);
+        logger.info('========================================');
+        logger.info('');
+        logger.info(`  Gateway Port:  ${gatewayPort} (public)`);
+        logger.info(`  Service Port:  ${servicePort} (internal)`);
+        logger.info('');
+        if (authMode === 'basic' || authMode === 'auto') {
+            logger.info('  Control Panel Auth: HTTP Basic Auth');
+            logger.info('  ----------------------------------------');
+            logger.info(`    Username: ${basicAuthUser}`);
+            if (isPasswordAutoGenerated) {
+                logger.info(`    Password: ${basicAuthPassword}`);
+                logger.info('    (auto-generated, set BASIC_AUTH_PASSWORD to use a fixed password)');
+            }
+            else {
+                logger.info('    Password: ********** (from environment)');
+            }
+            logger.info('  ----------------------------------------');
+        }
+        else {
+            logger.info('  Control Panel Auth: None (not recommended)');
+        }
+        logger.info('');
+        logger.info('  Endpoints:');
+        logger.info(`    GET  /                    - Control Panel UI`);
+        logger.info(`    GET  /api/health          - Gateway health`);
+        logger.info(`    GET  /health              - Service health (proxied)`);
+        for (const apiPath of proxyPaths) {
+            logger.info(`    *    ${apiPath}/*             - Service API (proxied)`);
+        }
+        logger.info('========================================');
+        logger.info('');
+    };
+    const stop = async () => {
+        logger.info('Shutting down gateway...');
+        // Stop control panel
+        await controlPanel.stop();
+        // Stop internal service
+        if (service) {
+            await service.shutdown();
+            service.server.close();
+        }
+        logger.info('Gateway shutdown complete');
+    };
+    return {
+        controlPanel,
+        service,
+        start,
+        stop,
+        gatewayPort,
+        servicePort,
+    };
+}
+//# sourceMappingURL=gateway.js.map

package/dist/core/gateway.js.map

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

package/dist/core/health-manager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Health Check Manager
+ *
+ * Manages health checks for various services and provides aggregated status
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { HealthCheck, HealthCheckResult, HealthStatus, Logger } from './types.js';
+export declare class HealthManager {
+    private checks;
+    private results;
+    private intervals;
+    private logger;
+    constructor(logger: Logger);
+    /**
+     * Register a health check
+     */
+    register(check: HealthCheck): void;
+    /**
+     * Run a health check
+     */
+    private runCheck;
+    /**
+     * Run HTTP health check
+     */
+    private runHttpCheck;
+    /**
+     * Run TCP health check (simplified - just tries to connect)
+     */
+    private runTcpCheck;
+    /**
+     * Get all health check results
+     */
+    getResults(): Record<string, HealthCheckResult>;
+    /**
+     * Get specific health check result
+     */
+    getResult(name: string): HealthCheckResult | undefined;
+    /**
+     * Get aggregated status
+     */
+    getAggregatedStatus(): HealthStatus;
+    /**
+     * Force run all checks
+     */
+    checkAll(): Promise<void>;
+    /**
+     * Shutdown - clear all intervals
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=health-manager.d.ts.map

package/dist/core/health-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-manager.d.ts","sourceRoot":"","sources":["../../src/core/health-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEvF,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,SAAS,CAA0D;IAC3E,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAyBlC;;OAEG;YACW,QAAQ;IA2DtB;;OAEG;YACW,YAAY;IAmC1B;;OAEG;YACW,WAAW;IAuBzB;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAI/C;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAItD;;OAEG;IACH,mBAAmB,IAAI,YAAY;IAiBnC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;OAEG;IACH,QAAQ,IAAI,IAAI;CAOjB"}

package/dist/core/health-manager.js

@@ -0,0 +1,192 @@
+/**
+ * Health Check Manager
+ *
+ * Manages health checks for various services and provides aggregated status
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export class HealthManager {
+    constructor(logger) {
+        this.checks = new Map();
+        this.results = new Map();
+        this.intervals = new Map();
+        this.logger = logger;
+    }
+    /**
+     * Register a health check
+     */
+    register(check) {
+        this.checks.set(check.name, check);
+        // Initialize result
+        this.results.set(check.name, {
+            status: 'unknown',
+            lastChecked: new Date(),
+        });
+        // Start periodic check
+        const interval = check.interval || 30000; // Default 30 seconds
+        this.runCheck(check.name);
+        const timer = setInterval(() => {
+            this.runCheck(check.name);
+        }, interval);
+        this.intervals.set(check.name, timer);
+        this.logger.info(`[HealthManager] Registered health check: ${check.name}`, {
+            type: check.type,
+            interval,
+        });
+    }
+    /**
+     * Run a health check
+     */
+    async runCheck(name) {
+        const check = this.checks.get(name);
+        if (!check)
+            return;
+        const startTime = Date.now();
+        const timeout = check.timeout || 5000;
+        try {
+            let result;
+            switch (check.type) {
+                case 'http':
+                    result = await this.runHttpCheck(check, timeout);
+                    break;
+                case 'tcp':
+                    result = await this.runTcpCheck(check, timeout);
+                    break;
+                case 'custom':
+                    if (check.check) {
+                        result = await Promise.race([
+                            check.check(),
+                            new Promise((_, reject) => setTimeout(() => reject(new Error('Timeout')), timeout)),
+                        ]);
+                    }
+                    else {
+                        result = { healthy: false, details: { error: 'No check function provided' } };
+                    }
+                    break;
+                default:
+                    result = { healthy: false, details: { error: 'Unknown check type' } };
+            }
+            const latency = result.latency || Date.now() - startTime;
+            this.results.set(name, {
+                status: result.healthy ? 'healthy' : 'unhealthy',
+                latency,
+                lastChecked: new Date(),
+                details: result.details,
+            });
+        }
+        catch (error) {
+            const latency = Date.now() - startTime;
+            const message = error instanceof Error ? error.message : String(error);
+            this.results.set(name, {
+                status: 'unhealthy',
+                latency,
+                message,
+                lastChecked: new Date(),
+            });
+            this.logger.warn(`[HealthManager] Health check failed: ${name}`, {
+                error: message,
+                latency,
+            });
+        }
+    }
+    /**
+     * Run HTTP health check
+     */
+    async runHttpCheck(check, timeout) {
+        if (!check.url) {
+            return { healthy: false, details: { error: 'No URL provided' } };
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const startTime = Date.now();
+            const response = await fetch(check.url, {
+                method: 'GET',
+                signal: controller.signal,
+            });
+            const latency = Date.now() - startTime;
+            clearTimeout(timeoutId);
+            return {
+                healthy: response.ok,
+                latency,
+                details: {
+                    status: response.status,
+                    statusText: response.statusText,
+                },
+            };
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            throw error;
+        }
+    }
+    /**
+     * Run TCP health check (simplified - just tries to connect)
+     */
+    async runTcpCheck(check, timeout) {
+        if (!check.host || !check.port) {
+            return { healthy: false, details: { error: 'Host and port required for TCP check' } };
+        }
+        // Use HTTP check as a proxy for TCP (simplified for browser compatibility)
+        // In a real Node.js environment, you'd use net.createConnection
+        const url = `http://${check.host}:${check.port}`;
+        try {
+            return await this.runHttpCheck({ ...check, url }, timeout);
+        }
+        catch {
+            // TCP check failed
+            return {
+                healthy: false,
+                details: { error: `Cannot connect to ${check.host}:${check.port}` },
+            };
+        }
+    }
+    /**
+     * Get all health check results
+     */
+    getResults() {
+        return Object.fromEntries(this.results);
+    }
+    /**
+     * Get specific health check result
+     */
+    getResult(name) {
+        return this.results.get(name);
+    }
+    /**
+     * Get aggregated status
+     */
+    getAggregatedStatus() {
+        const results = Array.from(this.results.values());
+        if (results.length === 0)
+            return 'unknown';
+        const unhealthyCount = results.filter((r) => r.status === 'unhealthy').length;
+        const degradedCount = results.filter((r) => r.status === 'degraded').length;
+        if (unhealthyCount > 0)
+            return 'unhealthy';
+        if (degradedCount > 0)
+            return 'degraded';
+        const hasUnknown = results.some((r) => r.status === 'unknown');
+        if (hasUnknown)
+            return 'unknown';
+        return 'healthy';
+    }
+    /**
+     * Force run all checks
+     */
+    async checkAll() {
+        const promises = Array.from(this.checks.keys()).map((name) => this.runCheck(name));
+        await Promise.all(promises);
+    }
+    /**
+     * Shutdown - clear all intervals
+     */
+    shutdown() {
+        for (const timer of this.intervals.values()) {
+            clearInterval(timer);
+        }
+        this.intervals.clear();
+        this.logger.info('[HealthManager] Shutdown complete');
+    }
+}
+//# sourceMappingURL=health-manager.js.map

package/dist/core/health-manager.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Core exports for @qwickapps/server
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { createControlPanel } from './control-panel.js';
+export type { CreateControlPanelOptions } from './control-panel.js';
+export { HealthManager } from './health-manager.js';
+export type { ControlPanelConfig, ControlPanelPlugin, ControlPanelInstance, PluginContext, HealthCheck, HealthCheckType, HealthStatus, HealthCheckResult, LogSource, ConfigDisplayOptions, Logger, DiagnosticsReport, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,oBAAoB,EACpB,MAAM,EACN,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,8 @@
+/**
+ * Core exports for @qwickapps/server
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { createControlPanel } from './control-panel.js';
+export { HealthManager } from './health-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/logging.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Control Panel Logging Subsystem
+ *
+ * Provides centralized logging for the control panel and all plugins.
+ * Configures @qwickapps/logging to write to files that the LogsPage can display.
+ *
+ * Environment Variables:
+ *   LOG_LEVEL          - Minimum log level (debug, info, warn, error). Default: debug in dev, info in prod
+ *   LOG_DIR            - Directory for log files. Default: ./logs
+ *   LOG_FILE           - Enable file logging. Default: true
+ *   LOG_FILE_PATH      - Path to log file. Default: ./logs/app.log (used by pino if available)
+ *   LOG_CONSOLE        - Enable console output. Default: true
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { LogLevel } from '@qwickapps/logging';
+import type { Logger } from './types.js';
+export interface LoggingConfig {
+    /** Product namespace for log entries */
+    namespace?: string;
+    /** Minimum log level */
+    level?: LogLevel;
+    /** Directory for log files */
+    logDir?: string;
+    /** Enable file logging */
+    fileLogging?: boolean;
+    /** Enable console output */
+    consoleOutput?: boolean;
+}
+/**
+ * Logging subsystem instance
+ */
+declare class LoggingSubsystem {
+    private config;
+    private rootLogger;
+    private fileTransport;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the logging subsystem with configuration
+     */
+    initialize(config?: LoggingConfig): void;
+    /**
+     * Get a logger for a specific component/plugin
+     */
+    getLogger(namespace: string): Logger;
+    /**
+     * Get the root logger
+     */
+    getRootLogger(): Logger;
+    /**
+     * Check if file logging is enabled and working
+     */
+    isFileLoggingEnabled(): boolean;
+    /**
+     * Get the log directory path
+     */
+    getLogDir(): string;
+    /**
+     * Get the default log file paths
+     */
+    getLogPaths(): {
+        appLog: string;
+        errorLog: string;
+    };
+}
+/**
+ * Get or create the logging subsystem
+ */
+export declare function getLoggingSubsystem(): LoggingSubsystem;
+/**
+ * Initialize the logging subsystem with configuration
+ */
+export declare function initializeLogging(config?: LoggingConfig): LoggingSubsystem;
+/**
+ * Get a logger for a specific namespace
+ */
+export declare function getControlPanelLogger(namespace: string): Logger;
+/**
+ * Export for convenience
+ */
+export { LoggingSubsystem };
+//# sourceMappingURL=logging.d.ts.map

package/dist/core/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/core/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAoC,QAAQ,EAAgB,MAAM,oBAAoB,CAAC;AAC9F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAyDD;;GAEG;AACH,cAAM,gBAAgB;IACpB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,WAAW,CAAS;;IAO5B;;OAEG;IACH,UAAU,CAAC,MAAM,GAAE,aAAkB,GAAG,IAAI;IAwC5C;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAoBpC;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,WAAW,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;CAMpD;AAKD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,aAAkB,GAAG,gBAAgB,CAI9E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,CAAC"}