@zintrust/core 0.1.42 → 0.1.44

package/packages/workers/src/SLAMonitor.d.ts

@@ -0,0 +1,111 @@
+/**
+ * SLA Monitor
+ * SLA compliance checks and violation tracking for workers
+ * Sealed namespace for immutability
+ */
+export type ITimeRange = {
+    start: Date;
+    end: Date;
+};
+export interface ISLAConfig {
+    workerName: string;
+    metrics: {
+        maxLatencyP99: number;
+        minThroughput: number;
+        minAvailability: number;
+        maxErrorRate: number;
+        maxRecoveryTime: number;
+    };
+    alerting: {
+        channels: string[];
+        escalation: boolean;
+        cooldown: number;
+    };
+    reporting: {
+        interval: 'daily' | 'weekly' | 'monthly';
+        recipients: string[];
+    };
+}
+export type ISLAStatus = {
+    workerName: string;
+    status: 'compliant' | 'warning' | 'breach';
+    evaluatedAt: Date;
+    checks: {
+        latencyP99: {
+            value: number;
+            threshold: number;
+            status: 'pass' | 'warn' | 'fail';
+        };
+        throughput: {
+            value: number;
+            threshold: number;
+            status: 'pass' | 'warn' | 'fail';
+        };
+        availability: {
+            value: number;
+            threshold: number;
+            status: 'pass' | 'warn' | 'fail';
+        };
+        errorRate: {
+            value: number;
+            threshold: number;
+            status: 'pass' | 'warn' | 'fail';
+        };
+        recoveryTime: {
+            value: number;
+            threshold: number;
+            status: 'pass' | 'warn' | 'fail';
+        };
+    };
+};
+export type ISLAViolation = {
+    id: string;
+    workerName: string;
+    metric: keyof ISLAStatus['checks'];
+    expected: number;
+    actual: number;
+    timestamp: Date;
+    severity: 'warning' | 'critical';
+    message: string;
+};
+export type ISLAReport = {
+    generatedAt: Date;
+    period: ITimeRange;
+    totalWorkers: number;
+    totalChecks: number;
+    totalViolations: number;
+    complianceRate: number;
+    violations: ReadonlyArray<ISLAViolation>;
+    perWorker: Array<{
+        workerName: string;
+        violations: number;
+        complianceRate: number;
+    }>;
+};
+/**
+ * SLA Monitor - Sealed namespace
+ */
+export declare const SLAMonitor: Readonly<{
+    /**
+     * Define SLA for a worker
+     */
+    defineSLA(config: ISLAConfig): void;
+    /**
+     * Check SLA compliance for a worker
+     */
+    checkCompliance(workerName: string): Promise<ISLAStatus>;
+    /**
+     * Get SLA violations for a worker
+     */
+    getViolations(workerName: string, timeRange: ITimeRange): ReadonlyArray<ISLAViolation>;
+    /**
+     * Get SLA compliance report
+     */
+    getComplianceReport(timeRange: ITimeRange): ISLAReport;
+    /**
+     * Alert on SLA violation
+     */
+    alertOnViolation(violation: ISLAViolation): void;
+}>;
+export default SLAMonitor;
+//# sourceMappingURL=SLAMonitor.d.ts.map

package/packages/workers/src/SLAMonitor.d.ts.map

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

package/packages/workers/src/SLAMonitor.js

@@ -0,0 +1,274 @@
+/**
+ * SLA Monitor
+ * SLA compliance checks and violation tracking for workers
+ * Sealed namespace for immutability
+ */
+import { ErrorFactory, Logger, generateUuid } from '../../../src/index.js';
+import { HealthMonitor } from './HealthMonitor.js';
+import { WorkerMetrics } from './WorkerMetrics.js';
+const slaConfigs = new Map();
+const violationHistory = new Map();
+const lastAlertAt = new Map();
+const DEFAULT_LOOKBACK_MS = 60 * 60 * 1000;
+const quantile = (points, percentile) => {
+    if (points.length === 0)
+        return 0;
+    const sorted = [...points].sort((a, b) => a.value - b.value);
+    const index = Math.min(sorted.length - 1, Math.max(0, Math.floor(percentile * sorted.length)));
+    return sorted[index]?.value ?? 0;
+};
+const warnOnMaxThreshold = (value, threshold) => value >= threshold * 0.9 && value <= threshold;
+const warnOnMinThreshold = (value, threshold) => value <= threshold * 1.1 && value >= threshold;
+const evaluateMaxThreshold = (value, threshold) => {
+    if (value > threshold)
+        return 'fail';
+    if (warnOnMaxThreshold(value, threshold))
+        return 'warn';
+    return 'pass';
+};
+const evaluateMinThreshold = (value, threshold) => {
+    if (value < threshold)
+        return 'fail';
+    if (warnOnMinThreshold(value, threshold))
+        return 'warn';
+    return 'pass';
+};
+const storeViolation = (violation) => {
+    const history = violationHistory.get(violation.workerName) ?? [];
+    history.push(violation);
+    if (history.length > 1000) {
+        history.shift();
+    }
+    violationHistory.set(violation.workerName, history);
+};
+const calculateAvailability = (checks) => {
+    if (checks.length === 0)
+        return 0;
+    const upCount = checks.filter((check) => check.status === 'healthy' || check.status === 'degraded').length;
+    return (upCount / checks.length) * 100;
+};
+const calculateRecoveryTime = (checks) => {
+    if (checks.length < 2)
+        return 0;
+    const sorted = [...checks].sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
+    let currentDownAt = null;
+    let maxRecoverySeconds = 0;
+    for (const check of sorted) {
+        const isDown = check.status === 'critical';
+        if (isDown && currentDownAt === null) {
+            currentDownAt = check.timestamp;
+        }
+        if (!isDown && currentDownAt !== null) {
+            const recoverySeconds = (check.timestamp.getTime() - currentDownAt.getTime()) / 1000;
+            maxRecoverySeconds = Math.max(maxRecoverySeconds, recoverySeconds);
+            currentDownAt = null;
+        }
+    }
+    return Math.round(maxRecoverySeconds);
+};
+const loadHealthChecks = async (workerName, range) => {
+    const history = HealthMonitor.getHealthHistory(workerName);
+    const filtered = history.filter((check) => check.timestamp.getTime() >= range.start.getTime() &&
+        check.timestamp.getTime() <= range.end.getTime());
+    if (filtered.length > 0)
+        return filtered;
+    try {
+        const current = HealthMonitor.getCurrentHealth(workerName);
+        return current ? [current] : [];
+    }
+    catch (error) {
+        Logger.debug('Failed to get current health for SLA check', error);
+        return [];
+    }
+};
+const getMetricPoints = async (workerName, metricType, range) => {
+    const entry = await WorkerMetrics.query({
+        workerName,
+        metricType,
+        granularity: 'hourly',
+        startDate: range.start,
+        endDate: range.end,
+    });
+    return entry.points;
+};
+const collectSlaMetrics = async (workerName, range) => {
+    const [durationPoints, processedAgg, errorAgg, healthChecks] = await Promise.all([
+        getMetricPoints(workerName, 'duration', range),
+        WorkerMetrics.aggregate({
+            workerName,
+            metricType: 'processed',
+            granularity: 'hourly',
+            startDate: range.start,
+            endDate: range.end,
+        }),
+        WorkerMetrics.aggregate({
+            workerName,
+            metricType: 'errors',
+            granularity: 'hourly',
+            startDate: range.start,
+            endDate: range.end,
+        }),
+        loadHealthChecks(workerName, range),
+    ]);
+    const latencyP99 = quantile(durationPoints, 0.99);
+    const minutes = Math.max(1, (range.end.getTime() - range.start.getTime()) / 60000);
+    const throughput = processedAgg.total / minutes;
+    const errorRate = processedAgg.total > 0 ? (errorAgg.total / processedAgg.total) * 100 : 0;
+    const availability = calculateAvailability(healthChecks);
+    const recoveryTime = calculateRecoveryTime(healthChecks);
+    return { latencyP99, throughput, availability, errorRate, recoveryTime };
+};
+const buildChecks = (metrics, config) => ({
+    latencyP99: {
+        value: metrics.latencyP99,
+        threshold: config.metrics.maxLatencyP99,
+        status: evaluateMaxThreshold(metrics.latencyP99, config.metrics.maxLatencyP99),
+    },
+    throughput: {
+        value: metrics.throughput,
+        threshold: config.metrics.minThroughput,
+        status: evaluateMinThreshold(metrics.throughput, config.metrics.minThroughput),
+    },
+    availability: {
+        value: metrics.availability,
+        threshold: config.metrics.minAvailability,
+        status: evaluateMinThreshold(metrics.availability, config.metrics.minAvailability),
+    },
+    errorRate: {
+        value: metrics.errorRate,
+        threshold: config.metrics.maxErrorRate,
+        status: evaluateMaxThreshold(metrics.errorRate, config.metrics.maxErrorRate),
+    },
+    recoveryTime: {
+        value: metrics.recoveryTime,
+        threshold: config.metrics.maxRecoveryTime,
+        status: evaluateMaxThreshold(metrics.recoveryTime, config.metrics.maxRecoveryTime),
+    },
+});
+const buildSlaStatus = (checks) => {
+    const hasFailures = Object.values(checks).some((check) => check.status === 'fail');
+    if (hasFailures)
+        return 'breach';
+    const hasWarnings = Object.values(checks).some((check) => check.status === 'warn');
+    return hasWarnings ? 'warning' : 'compliant';
+};
+const buildViolation = (params) => ({
+    id: generateUuid(),
+    workerName: params.workerName,
+    metric: params.metric,
+    expected: params.expected,
+    actual: params.actual,
+    timestamp: new Date(),
+    severity: params.severity,
+    message: params.message,
+});
+/**
+ * SLA Monitor - Sealed namespace
+ */
+export const SLAMonitor = Object.freeze({
+    /**
+     * Define SLA for a worker
+     */
+    defineSLA(config) {
+        slaConfigs.set(config.workerName, { ...config });
+        Logger.info(`SLA defined for worker "${config.workerName}"`);
+    },
+    /**
+     * Check SLA compliance for a worker
+     */
+    async checkCompliance(workerName) {
+        const config = slaConfigs.get(workerName);
+        if (!config) {
+            throw ErrorFactory.createNotFoundError(`SLA config not found for worker "${workerName}"`);
+        }
+        const range = {
+            start: new Date(Date.now() - DEFAULT_LOOKBACK_MS),
+            end: new Date(),
+        };
+        const metrics = await collectSlaMetrics(workerName, range);
+        const checks = buildChecks(metrics, config);
+        const status = buildSlaStatus(checks);
+        Object.entries(checks)
+            .filter(([, detail]) => detail.status === 'fail')
+            .forEach(([metricKey, detail]) => {
+            const violation = buildViolation({
+                workerName,
+                metric: metricKey,
+                expected: detail.threshold,
+                actual: detail.value,
+                severity: 'critical',
+                message: `SLA breach for ${metricKey}: ${detail.value} (expected ${detail.threshold})`,
+            });
+            storeViolation(violation);
+            SLAMonitor.alertOnViolation(violation);
+        });
+        return {
+            workerName,
+            status,
+            evaluatedAt: new Date(),
+            checks,
+        };
+    },
+    /**
+     * Get SLA violations for a worker
+     */
+    getViolations(workerName, timeRange) {
+        const history = violationHistory.get(workerName) ?? [];
+        return history.filter((violation) => violation.timestamp.getTime() >= timeRange.start.getTime() &&
+            violation.timestamp.getTime() <= timeRange.end.getTime());
+    },
+    /**
+     * Get SLA compliance report
+     */
+    getComplianceReport(timeRange) {
+        const violations = [];
+        const perWorker = [];
+        for (const [workerName] of slaConfigs.entries()) {
+            const workerViolations = SLAMonitor.getViolations(workerName, timeRange);
+            violations.push(...workerViolations);
+            const totalChecks = slaConfigs.size * 5;
+            const breachCount = workerViolations.length;
+            const complianceRate = totalChecks > 0 ? (totalChecks - breachCount) / totalChecks : 1;
+            perWorker.push({
+                workerName,
+                violations: breachCount,
+                complianceRate,
+            });
+        }
+        const totalChecks = slaConfigs.size * 5;
+        const totalViolations = violations.length;
+        const complianceRate = totalChecks > 0 ? (totalChecks - totalViolations) / totalChecks : 1;
+        return {
+            generatedAt: new Date(),
+            period: timeRange,
+            totalWorkers: slaConfigs.size,
+            totalChecks,
+            totalViolations,
+            complianceRate,
+            violations,
+            perWorker,
+        };
+    },
+    /**
+     * Alert on SLA violation
+     */
+    alertOnViolation(violation) {
+        const config = slaConfigs.get(violation.workerName);
+        if (!config)
+            return;
+        const lastAlert = lastAlertAt.get(violation.workerName);
+        const cooldownMs = config.alerting.cooldown * 60 * 1000;
+        if (lastAlert && Date.now() - lastAlert.getTime() < cooldownMs) {
+            return;
+        }
+        lastAlertAt.set(violation.workerName, new Date());
+        Logger.warn(`SLA violation for ${violation.workerName}`, {
+            metric: violation.metric,
+            expected: violation.expected,
+            actual: violation.actual,
+            severity: violation.severity,
+            channels: config.alerting.channels,
+        });
+    },
+});
+export default SLAMonitor;

package/packages/workers/src/WorkerFactory.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Worker Factory
+ * Central factory for creating workers with all advanced features
+ * Sealed namespace for immutability
+ */
+import { type IDatabase, type RedisConfig } from '../../../src/index.js';
+import { Worker, type Job, type WorkerOptions } from 'bullmq';
+import { type AutoScalerConfig } from './AutoScaler';
+import { type ComplianceConfig } from './ComplianceManager';
+import { type RetentionPolicy } from './DeadLetterQueue';
+import { type ObservabilityConfig } from './Observability';
+import { type WorkerRecord } from './storage/WorkerStore';
+export declare const WorkerCreationStatus: {
+    readonly CREATING: "creating";
+    readonly CONNECTING: "connecting";
+    readonly STARTING: "starting";
+    readonly RUNNING: "running";
+    readonly FAILED: "failed";
+    readonly STOPPED: "stopped";
+};
+export type WorkerCreationStatus = (typeof WorkerCreationStatus)[keyof typeof WorkerCreationStatus];
+export type WorkerFactoryConfig = {
+    name: string;
+    version?: string;
+    queueName: string;
+    processor: (job: Job) => Promise<unknown>;
+    processorSpec?: string;
+    options?: WorkerOptions;
+    autoStart?: boolean;
+    activeStatus?: boolean;
+    infrastructure?: {
+        redis?: RedisConfigInput;
+        persistence?: WorkerPersistenceConfig;
+        deadLetterQueue?: {
+            redis?: RedisConfigInput;
+            policy: RetentionPolicy;
+        };
+        compliance?: {
+            redis?: RedisConfigInput;
+            config?: Partial<ComplianceConfig>;
+        };
+        observability?: ObservabilityConfigInput;
+        autoScaler?: AutoScalerConfig;
+    };
+    features?: {
+        clustering?: boolean;
+        metrics?: boolean;
+        autoScaling?: boolean;
+        circuitBreaker?: boolean;
+        deadLetterQueue?: boolean;
+        resourceMonitoring?: boolean;
+        compliance?: boolean;
+        observability?: boolean;
+        plugins?: boolean;
+        versioning?: boolean;
+        datacenterOrchestration?: boolean;
+    };
+    datacenter?: {
+        primaryRegion: string;
+        secondaryRegions?: string[];
+        affinityRules?: {
+            preferLocal?: boolean;
+            maxLatency?: number;
+            avoidRegions?: string[];
+        };
+    };
+};
+export type WorkerInstance = {
+    worker: Worker;
+    config: WorkerFactoryConfig;
+    startedAt: Date;
+    status: WorkerCreationStatus;
+    lastHealthCheck?: Date;
+    connectionState?: 'disconnected' | 'connecting' | 'connected' | 'error';
+};
+type RedisEnvConfig = {
+    env?: true;
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: string;
+};
+type RedisConfigInput = RedisConfig | RedisEnvConfig;
+export type WorkerPersistenceConfig = {
+    driver: 'memory';
+} | {
+    driver: 'redis';
+    redis?: RedisConfigInput;
+    keyPrefix?: string;
+} | {
+    driver: 'database';
+    client?: IDatabase | string;
+    connection?: string;
+    table?: string;
+};
+type ObservabilityConfigInput = ObservabilityConfig | {
+    enabled?: boolean;
+    prometheus?: Partial<ObservabilityConfig['prometheus']>;
+    openTelemetry?: Partial<ObservabilityConfig['openTelemetry']>;
+    datadog?: Partial<ObservabilityConfig['datadog']>;
+};
+export type ProcessorResolver = (name: string) => WorkerFactoryConfig['processor'] | undefined | Promise<WorkerFactoryConfig['processor'] | undefined>;
+/**
+ * Worker Factory - Sealed namespace
+ */
+export declare const WorkerFactory: Readonly<{
+    registerProcessor: (name: string, processor: WorkerFactoryConfig["processor"]) => void;
+    registerProcessors: (processors: Record<string, WorkerFactoryConfig["processor"]>) => void;
+    registerProcessorPaths: (paths: Record<string, string>) => void;
+    registerProcessorResolver: (resolver: ProcessorResolver) => void;
+    registerProcessorSpec: (spec: string, processor: WorkerFactoryConfig["processor"]) => void;
+    resolveProcessorPath: (modulePath: string) => Promise<WorkerFactoryConfig["processor"] | undefined>;
+    resolveProcessorSpec: (spec: string) => Promise<WorkerFactoryConfig["processor"] | undefined>;
+    /**
+     * Register a new worker configuration without starting it.
+     */
+    register(config: WorkerFactoryConfig): Promise<void>;
+    /**
+     * Create new worker with full setup
+     */
+    create(config: WorkerFactoryConfig): Promise<Worker>;
+    /**
+     * Get worker instance
+     */
+    get(name: string): WorkerInstance | null;
+    /**
+     * Update worker status directly (used by HealthMonitor)
+     */
+    updateStatus(name: string, status: string, error?: Error | string): Promise<void>;
+    /**
+     * Stop worker
+     */
+    stop(name: string, persistenceOverride?: WorkerPersistenceConfig, options?: {
+        skipPersistedUpdate?: boolean;
+    }): Promise<void>;
+    /**
+     * Restart worker
+     */
+    restart(name: string, persistenceOverride?: WorkerPersistenceConfig): Promise<void>;
+    /**
+     * Pause worker
+     */
+    pause(name: string, persistenceOverride?: WorkerPersistenceConfig): Promise<void>;
+    /**
+     * Resume worker
+     */
+    resume(name: string, persistenceOverride?: WorkerPersistenceConfig): Promise<void>;
+    /**
+     * Update auto-start for persisted worker
+     */
+    setAutoStart(name: string, autoStart: boolean, persistenceOverride?: WorkerPersistenceConfig): Promise<void>;
+    /**
+     * Update active status for a worker
+     */
+    setWorkerActiveStatus(name: string, activeStatus: boolean, persistenceOverride?: WorkerPersistenceConfig): Promise<void>;
+    /**
+     * Get active status for a worker
+     */
+    getWorkerActiveStatus(name: string, persistenceOverride?: WorkerPersistenceConfig): Promise<boolean | null>;
+    /**
+     * Update persisted worker record and in-memory config if running.
+     */
+    update(name: string, patch: Partial<WorkerRecord> | WorkerRecord, persistenceOverride?: WorkerPersistenceConfig): Promise<void>;
+    /**
+     * Start worker
+     */
+    start(name: string, persistenceOverride?: WorkerPersistenceConfig): Promise<void>;
+    /**
+     * List all workers
+     */
+    list(): string[];
+    /**
+     * List all persisted workers
+     */
+    listPersisted(persistenceOverride?: WorkerPersistenceConfig, options?: {
+        offset?: number;
+        limit?: number;
+        search?: string;
+        includeInactive?: boolean;
+    }): Promise<string[]>;
+    listPersistedRecords(persistenceOverride?: WorkerPersistenceConfig, options?: {
+        offset?: number;
+        limit?: number;
+        search?: string;
+        includeInactive?: boolean;
+    }): Promise<WorkerRecord[]>;
+    /**
+     * Start a worker from persisted storage when it is not registered.
+     */
+    startFromPersisted(name: string, persistenceOverride?: WorkerPersistenceConfig): Promise<void>;
+    /**
+     * Get persisted worker record
+     */
+    getPersisted(name: string, persistenceOverride?: WorkerPersistenceConfig): Promise<WorkerRecord | null>;
+    /**
+     * Remove worker
+     */
+    remove(name: string, persistenceOverride?: WorkerPersistenceConfig): Promise<void>;
+    /**
+     * Get worker metrics
+     */
+    getMetrics(name: string): Promise<unknown>;
+    /**
+     * Get worker health
+     */
+    getHealth(name: string): Promise<unknown>;
+    /**
+     * Shutdown all workers
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Reset persistence connection state.
+     * Useful when connections become stale in long-running processes or serverless environments.
+     */
+    resetPersistence(): Promise<void>;
+}>;
+export {};
+//# sourceMappingURL=WorkerFactory.d.ts.map

package/packages/workers/src/WorkerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerFactory.d.ts","sourceRoot":"","sources":["../../../../packages/workers/src/WorkerFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAgBL,KAAK,SAAS,EACd,KAAK,WAAW,EAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIjE,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG1E,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAQ1E,OAAO,EAIL,KAAK,YAAY,EAElB,MAAM,uBAAuB,CAAC;AA8M/B,eAAO,MAAM,oBAAoB;;;;;;;CAOvB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAWpG,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE;QACf,KAAK,CAAC,EAAE,gBAAgB,CAAC;QACzB,WAAW,CAAC,EAAE,uBAAuB,CAAC;QACtC,eAAe,CAAC,EAAE;YAChB,KAAK,CAAC,EAAE,gBAAgB,CAAC;YACzB,MAAM,EAAE,eAAe,CAAC;SACzB,CAAC;QACF,UAAU,CAAC,EAAE;YACX,KAAK,CAAC,EAAE,gBAAgB,CAAC;YACzB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;SACpC,CAAC;QACF,aAAa,CAAC,EAAE,wBAAwB,CAAC;QACzC,UAAU,CAAC,EAAE,gBAAgB,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,uBAAuB,CAAC,EAAE,OAAO,CAAC;KACnC,CAAC;IACF,UAAU,CAAC,EAAE;QACX,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,aAAa,CAAC,EAAE;YACd,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;SACzB,CAAC;KACH,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;CACzE,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,KAAK,gBAAgB,GAAG,WAAW,GAAG,cAAc,CAAC;AAErD,MAAM,MAAM,uBAAuB,GAC/B;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7F,KAAK,wBAAwB,GACzB,mBAAmB,GACnB;IACE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;IACxD,aAAa,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC;CACnD,CAAC;AAQN,MAAM,MAAM,iBAAiB,GAAG,CAC9B,IAAI,EAAE,MAAM,KAEV,mBAAmB,CAAC,WAAW,CAAC,GAChC,SAAS,GACT,OAAO,CAAC,mBAAmB,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,CAAC;AAi3D1D;;GAEG;AACH,eAAO,MAAM,aAAa;8BAv0DO,MAAM,aAAa,mBAAmB,CAAC,WAAW,CAAC,KAAG,IAAI;qCAInD,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC,KAAG,IAAI;oCAQxD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,IAAI;0CAQvB,iBAAiB,KAAG,IAAI;kCAIhC,MAAM,aAAa,mBAAmB,CAAC,WAAW,CAAC,KAAG,IAAI;uCA6hBjF,MAAM,KACjB,OAAO,CAAC,mBAAmB,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;iCA5FhD,MAAM,KACX,OAAO,CAAC,mBAAmB,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAq3CtD;;OAEG;qBACoB,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B1D;;OAEG;mBACkB,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAqG1D;;OAEG;cACO,MAAM,GAAG,cAAc,GAAG,IAAI;IAKxC;;OAEG;uBACsB,MAAM,UAAU,MAAM,UAAU,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BvF;;OAEG;eAEK,MAAM,wBACU,uBAAuB,YACnC;QAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1C,OAAO,CAAC,IAAI,CAAC;IAyEhB;;OAEG;kBACiB,MAAM,wBAAwB,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BzF;;OAEG;gBACe,MAAM,wBAAwB,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvF;;OAEG;iBACgB,MAAM,wBAAwB,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxF;;OAEG;uBAEK,MAAM,aACD,OAAO,wBACI,uBAAuB,GAC5C,OAAO,CAAC,IAAI,CAAC;IAuBhB;;OAEG;gCAEK,MAAM,gBACE,OAAO,wBACC,uBAAuB,GAC5C,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;gCAEK,MAAM,wBACU,uBAAuB,GAC5C,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAY1B;;OAEG;iBAEK,MAAM,SACL,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,wBACrB,uBAAuB,GAC5C,OAAO,CAAC,IAAI,CAAC;IAsChB;;OAEG;gBACe,MAAM,wBAAwB,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BvF;;OAEG;YACK,MAAM,EAAE;IAIhB;;OAEG;wCAEqB,uBAAuB,YACnC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GACxF,OAAO,CAAC,MAAM,EAAE,CAAC;+CAMI,uBAAuB,YACnC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GACxF,OAAO,CAAC,YAAY,EAAE,CAAC;IA6B1B;;OAEG;6BAEK,MAAM,wBACU,uBAAuB,GAC5C,OAAO,CAAC,IAAI,CAAC;IA0ChB;;OAEG;uBAEK,MAAM,wBACU,uBAAuB,GAC5C,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAc/B;;OAEG;iBACgB,MAAM,wBAAwB,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BxF;;OAEG;qBACoB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBhD;;OAEG;oBACmB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB/C;;OAEG;gBACe,OAAO,CAAC,IAAI,CAAC;IAmE/B;;;OAGG;wBACuB,OAAO,CAAC,IAAI,CAAC;EAMvC,CAAC"}