threadforge 0.1.1 → 0.2.1

package/dist/core/Logger.js

@@ -0,0 +1,77 @@
+const LOG_LEVELS = { error: 0, warn: 1, info: 2, debug: 3 };
+const DEFAULT_REDACTED_FIELDS = new Set([
+    "password", "passwd", "secret", "token", "authorization",
+    "cookie", "ssn", "creditcard", "credit_card", "cardnumber",
+    "card_number", "api_key", "apikey", "access_token", "refresh_token",
+    "private_key", "privatekey",
+]);
+const REDACTED = "[REDACTED]";
+function redact(obj, fields) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (fields.has(key.toLowerCase())) {
+            result[key] = REDACTED;
+        }
+        else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+            result[key] = redact(value, fields);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * O5: Structured logger with service context and log level filtering.
+ */
+export class Logger {
+    serviceName;
+    workerId;
+    _level;
+    _redactedFields;
+    constructor(serviceName, workerId) {
+        this.serviceName = serviceName;
+        this.workerId = workerId;
+        // O5: Default log level is 'info'
+        this._level = LOG_LEVELS[process.env.FORGE_LOG_LEVEL?.toLowerCase() ?? ""] ?? LOG_LEVELS.info;
+        this._redactedFields = new Set(DEFAULT_REDACTED_FIELDS);
+    }
+    /**
+     * O5: Set the log level dynamically.
+     */
+    setLogLevel(level) {
+        const numeric = LOG_LEVELS[level];
+        if (numeric === undefined)
+            return;
+        this._level = numeric;
+    }
+    _log(level, message, meta = {}) {
+        // O5: Filter messages below current log level
+        if (LOG_LEVELS[level] > this._level)
+            return;
+        const safe = redact(meta, this._redactedFields);
+        const entry = {
+            ...safe,
+            timestamp: new Date().toISOString(),
+            level,
+            service: this.serviceName,
+            worker: this.workerId,
+            message,
+        };
+        const output = level === "error" ? process.stderr : process.stdout;
+        output.write(`${JSON.stringify(entry)}\n`);
+    }
+    debug(msg, meta) {
+        this._log("debug", msg, meta);
+    }
+    info(msg, meta) {
+        this._log("info", msg, meta);
+    }
+    warn(msg, meta) {
+        this._log("warn", msg, meta);
+    }
+    error(msg, meta) {
+        this._log("error", msg, meta);
+    }
+}
+//# sourceMappingURL=Logger.js.map

package/dist/core/Logger.js.map

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

package/dist/core/MessageBus.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MessageBus
+ *
+ * @deprecated Removed. Use DirectMessageBus instead.
+ *
+ * MessageBus used older cluster IPC with round-robin dispatch.
+ * DirectMessageBus provides Unix Domain Socket mesh for direct
+ * worker-to-worker communication with better performance.
+ *
+ * See the migration guide at docs/guides/ipc.md
+ */
+export declare class MessageBus {
+    constructor();
+}
+//# sourceMappingURL=MessageBus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MessageBus.d.ts","sourceRoot":"","sources":["../../src/core/MessageBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;;CAOtB"}

package/dist/core/MessageBus.js

@@ -0,0 +1,18 @@
+/**
+ * MessageBus
+ *
+ * @deprecated Removed. Use DirectMessageBus instead.
+ *
+ * MessageBus used older cluster IPC with round-robin dispatch.
+ * DirectMessageBus provides Unix Domain Socket mesh for direct
+ * worker-to-worker communication with better performance.
+ *
+ * See the migration guide at docs/guides/ipc.md
+ */
+export class MessageBus {
+    constructor() {
+        throw new Error("MessageBus is deprecated and has been removed. Use DirectMessageBus instead. " +
+            "See the migration guide at docs/guides/ipc.md");
+    }
+}
+//# sourceMappingURL=MessageBus.js.map

package/dist/core/MessageBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageBus.js","sourceRoot":"","sources":["../../src/core/MessageBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,UAAU;IACrB;QACE,MAAM,IAAI,KAAK,CACb,+EAA+E;YAC7E,+CAA+C,CAClD,CAAC;IACJ,CAAC;CACF"}

package/dist/core/Prometheus.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Prometheus Metrics
+ *
+ * Proper Prometheus exposition format. Auto-tracks:
+ *
+ *   forge_http_request_duration_seconds  — histogram, per route + status + tenant
+ *   forge_http_requests_total            — counter, per route + status + tenant
+ *   forge_http_active_requests           — gauge, current in-flight
+ *   forge_rpc_duration_seconds           — histogram, per target + method
+ *   forge_rpc_total                      — counter, per target + method + success/error
+ *   forge_circuit_breaker_state          — gauge, 0=closed 1=open 2=half-open
+ *   forge_concurrency_limit              — gauge, per-service adaptive limit
+ *   forge_concurrency_in_flight          — gauge, per-service in-flight
+ *   forge_ws_connections_active          — gauge, current WebSocket connections
+ *   forge_ws_messages_total              — counter, WebSocket messages
+ *   forge_event_loop_lag_seconds         — gauge with percentiles (p50, p95, p99)
+ *
+ * GET /metrics → text/plain Prometheus format
+ *
+ * Usage:
+ *   const metrics = new PrometheusMetrics('users', 0);
+ *   metrics.httpRequestDuration(0.045, { method: 'GET', path: '/users/:id', status: 200, tenant_id: 't_acme' });
+ *   metrics.expose() → "# HELP forge_http_request_duration_seconds ..."
+ */
+import { monitorEventLoopDelay } from "node:perf_hooks";
+interface ErrorLike {
+    code?: string;
+    statusCode?: number;
+}
+type LabelValue = string | number | boolean | null | undefined;
+interface Labels {
+    [key: string]: LabelValue;
+}
+interface HistogramEntry {
+    count: number;
+    sum: number;
+    buckets: number[];
+    bucketBounds: number[];
+}
+/** P2: Normalize error codes to a finite set to prevent cardinality bombs */
+export declare function normalizeErrorCode(err: ErrorLike): string;
+export declare class PrometheusMetrics {
+    serviceName: string;
+    workerId: number;
+    startTime: number;
+    httpBuckets: number[];
+    rpcBuckets: number[];
+    _counters: Map<string, number>;
+    _gauges: Map<string, number>;
+    _histograms: Map<string, HistogramEntry>;
+    _eventLoopMonitor: ReturnType<typeof monitorEventLoopDelay> | null;
+    constructor(serviceName: string, workerId: number);
+    httpRequestStart(): void;
+    httpRequestEnd(durationSecs: number, labels?: Labels): void;
+    rpcCall(durationSecs: number, labels?: Labels): void;
+    wsConnectionOpen(): void;
+    wsConnectionClose(): void;
+    wsMessage(direction?: string): void;
+    concurrencyUpdate(target: string, limit: number, inFlight: number): void;
+    circuitBreakerState(target: string, state: string): void;
+    counter(name: string, value?: number, labels?: Labels): void;
+    gauge(name: string, value: number, labels?: Labels): void;
+    histogram(name: string, value: number, labels?: Labels, buckets?: number[]): void;
+    /**
+     * Render all metrics in Prometheus text exposition format.
+     */
+    expose(): string;
+    _labelStr(labels: Labels): string;
+    _counterInc(name: string, labels?: Labels, value?: number): void;
+    _gaugeSet(name: string, value: number, labels?: Labels): void;
+    _gaugeInc(name: string, labels?: Labels): void;
+    _gaugeDec(name: string, labels?: Labels): void;
+    _histogramObserve(name: string, value: number, labels: Labels | undefined, buckets: number[]): void;
+    /**
+     * OPS-8: Cleanup event loop monitor when metrics instance is no longer needed
+     */
+    cleanup(): void;
+}
+export {};
+//# sourceMappingURL=Prometheus.d.ts.map

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

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

package/dist/core/Prometheus.js

@@ -0,0 +1,332 @@
+/**
+ * Prometheus Metrics
+ *
+ * Proper Prometheus exposition format. Auto-tracks:
+ *
+ *   forge_http_request_duration_seconds  — histogram, per route + status + tenant
+ *   forge_http_requests_total            — counter, per route + status + tenant
+ *   forge_http_active_requests           — gauge, current in-flight
+ *   forge_rpc_duration_seconds           — histogram, per target + method
+ *   forge_rpc_total                      — counter, per target + method + success/error
+ *   forge_circuit_breaker_state          — gauge, 0=closed 1=open 2=half-open
+ *   forge_concurrency_limit              — gauge, per-service adaptive limit
+ *   forge_concurrency_in_flight          — gauge, per-service in-flight
+ *   forge_ws_connections_active          — gauge, current WebSocket connections
+ *   forge_ws_messages_total              — counter, WebSocket messages
+ *   forge_event_loop_lag_seconds         — gauge with percentiles (p50, p95, p99)
+ *
+ * GET /metrics → text/plain Prometheus format
+ *
+ * Usage:
+ *   const metrics = new PrometheusMetrics('users', 0);
+ *   metrics.httpRequestDuration(0.045, { method: 'GET', path: '/users/:id', status: 200, tenant_id: 't_acme' });
+ *   metrics.expose() → "# HELP forge_http_request_duration_seconds ..."
+ */
+import { monitorEventLoopDelay } from "node:perf_hooks";
+const ALLOWED_HTTP_LABELS = new Set(["method", "status", "route_pattern", "service", "status_code"]);
+const ALLOWED_RPC_LABELS = new Set(["target", "method", "result", "service"]);
+/** P2: Normalize error codes to a finite set to prevent cardinality bombs */
+export function normalizeErrorCode(err) {
+    if (err.code === "ETIMEDOUT" || err.code === "TIMEOUT")
+        return "timeout";
+    if (err.code === "ECONNREFUSED" || err.code === "ECONNRESET")
+        return "connection";
+    if (err.statusCode !== undefined && err.statusCode >= 500)
+        return "server_error";
+    if (err.statusCode !== undefined && err.statusCode >= 400)
+        return "client_error";
+    if (err.code === "CIRCUIT_OPEN")
+        return "circuit_open";
+    return "unknown";
+}
+/** P9: Cache label key string construction */
+const _labelKeyCache = new Map();
+const MAX_LABEL_KEY_CACHE = 10000;
+const MAX_METRIC_SERIES = 50000;
+let _seriesCapWarned = false;
+function filterLabels(labels, allowed) {
+    const filtered = {};
+    for (const key of Object.keys(labels)) {
+        if (allowed.has(key))
+            filtered[key] = labels[key];
+    }
+    return filtered;
+}
+export class PrometheusMetrics {
+    serviceName;
+    workerId;
+    startTime;
+    httpBuckets;
+    rpcBuckets;
+    _counters;
+    _gauges;
+    _histograms;
+    _eventLoopMonitor;
+    constructor(serviceName, workerId) {
+        this.serviceName = serviceName;
+        this.workerId = workerId;
+        this.startTime = Date.now();
+        // Histogram buckets (seconds)
+        this.httpBuckets = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+        this.rpcBuckets = [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.5, 1, 5];
+        this._counters = new Map();
+        this._gauges = new Map();
+        this._histograms = new Map();
+        // OPS-8: Event loop lag monitoring
+        // Resolution of 10ms provides good balance between overhead and accuracy
+        // Overhead is minimal (~0.1% CPU) as this uses native perf_hooks
+        this._eventLoopMonitor = monitorEventLoopDelay({ resolution: 10 });
+        this._eventLoopMonitor.enable();
+    }
+    // ── Auto-tracked methods ──
+    httpRequestStart() {
+        this._gaugeInc("forge_http_active_requests", { service: this.serviceName });
+    }
+    httpRequestEnd(durationSecs, labels = {}) {
+        const filtered = filterLabels({ service: this.serviceName, ...labels }, ALLOWED_HTTP_LABELS);
+        this._gaugeDec("forge_http_active_requests", { service: this.serviceName });
+        this._histogramObserve("forge_http_request_duration_seconds", durationSecs, filtered, this.httpBuckets);
+        this._counterInc("forge_http_requests_total", filtered);
+    }
+    rpcCall(durationSecs, labels = {}) {
+        const filtered = filterLabels({ service: this.serviceName, ...labels }, ALLOWED_RPC_LABELS);
+        this._histogramObserve("forge_rpc_duration_seconds", durationSecs, {
+            source: this.serviceName,
+            ...filtered,
+        }, this.rpcBuckets);
+        this._counterInc("forge_rpc_total", {
+            source: this.serviceName,
+            ...filtered,
+        });
+    }
+    wsConnectionOpen() {
+        this._gaugeInc("forge_ws_connections_active", { service: this.serviceName });
+    }
+    wsConnectionClose() {
+        this._gaugeDec("forge_ws_connections_active", { service: this.serviceName });
+    }
+    wsMessage(direction = "inbound") {
+        this._counterInc("forge_ws_messages_total", {
+            service: this.serviceName,
+            direction,
+        });
+    }
+    concurrencyUpdate(target, limit, inFlight) {
+        this._gaugeSet("forge_concurrency_limit", limit, {
+            source: this.serviceName,
+            target,
+        });
+        this._gaugeSet("forge_concurrency_in_flight", inFlight, {
+            source: this.serviceName,
+            target,
+        });
+    }
+    circuitBreakerState(target, state) {
+        // 0=closed, 1=open, 2=half-open
+        const val = state === "open" ? 1 : state === "half-open" ? 2 : 0;
+        this._gaugeSet("forge_circuit_breaker_state", val, {
+            source: this.serviceName,
+            target,
+        });
+    }
+    // ── Generic methods (for custom metrics) ──
+    counter(name, value = 1, labels = {}) {
+        this._counterInc(name, { service: this.serviceName, ...labels }, value);
+    }
+    gauge(name, value, labels = {}) {
+        this._gaugeSet(name, value, { service: this.serviceName, ...labels });
+    }
+    histogram(name, value, labels = {}, buckets) {
+        this._histogramObserve(name, value, { service: this.serviceName, ...labels }, buckets || this.httpBuckets);
+    }
+    // ── Exposition ──
+    /**
+     * Render all metrics in Prometheus text exposition format.
+     */
+    expose() {
+        const lines = [];
+        const now = Date.now();
+        // Uptime
+        lines.push(`# HELP forge_uptime_seconds Service uptime`);
+        lines.push(`# TYPE forge_uptime_seconds gauge`);
+        lines.push(`forge_uptime_seconds{service="${this.serviceName}",worker="${this.workerId}"} ${((now - this.startTime) / 1000).toFixed(1)}`);
+        lines.push("");
+        // Counters
+        const counterNames = new Set([...this._counters.keys()].map((k) => k.split("{")[0]));
+        for (const name of counterNames) {
+            lines.push(`# HELP ${name} ${name}`);
+            lines.push(`# TYPE ${name} counter`);
+            for (const [key, val] of this._counters) {
+                if (key === name || key.startsWith(`${name}{`)) {
+                    lines.push(`${key} ${val}`);
+                }
+            }
+            lines.push("");
+        }
+        // Gauges
+        const gaugeNames = new Set([...this._gauges.keys()].map((k) => k.split("{")[0]));
+        for (const name of gaugeNames) {
+            lines.push(`# HELP ${name} ${name}`);
+            lines.push(`# TYPE ${name} gauge`);
+            for (const [key, val] of this._gauges) {
+                if (key === name || key.startsWith(`${name}{`)) {
+                    lines.push(`${key} ${val}`);
+                }
+            }
+            lines.push("");
+        }
+        // Histograms
+        const histNames = new Set([...this._histograms.keys()].map((k) => k.split("{")[0]));
+        for (const name of histNames) {
+            lines.push(`# HELP ${name} ${name}`);
+            lines.push(`# TYPE ${name} histogram`);
+            for (const [key, hist] of this._histograms) {
+                if (key !== name && !key.startsWith(`${name}{`))
+                    continue;
+                const labelPart = key.includes("{") ? key.slice(key.indexOf("{")) : "";
+                const prefix = name;
+                // Bucket lines
+                const buckets = hist.bucketBounds;
+                for (let i = 0; i < buckets.length; i++) {
+                    const le = buckets[i];
+                    const bucketLabel = labelPart ? labelPart.replace("}", `,le="${le}"}`) : `{le="${le}"}`;
+                    lines.push(`${prefix}_bucket${bucketLabel} ${hist.buckets[i]}`);
+                }
+                const infLabel = labelPart ? labelPart.replace("}", `,le="+Inf"}`) : `{le="+Inf"}`;
+                lines.push(`${prefix}_bucket${infLabel} ${hist.count}`);
+                lines.push(`${prefix}_sum${labelPart} ${hist.sum.toFixed(6)}`);
+                lines.push(`${prefix}_count${labelPart} ${hist.count}`);
+            }
+            lines.push("");
+        }
+        // Process metrics
+        const mem = process.memoryUsage();
+        lines.push(`# HELP process_resident_memory_bytes Resident memory size in bytes`);
+        lines.push(`# TYPE process_resident_memory_bytes gauge`);
+        lines.push(`process_resident_memory_bytes{service="${this.serviceName}"} ${mem.rss}`);
+        lines.push(`# HELP process_heap_used_bytes Node.js heap used in bytes`);
+        lines.push(`# TYPE process_heap_used_bytes gauge`);
+        lines.push(`process_heap_used_bytes{service="${this.serviceName}"} ${mem.heapUsed}`);
+        lines.push("");
+        // OPS-8: Event loop lag metrics
+        if (this._eventLoopMonitor) {
+            const monitor = this._eventLoopMonitor;
+            const baseLabels = `service="${this.serviceName}",worker="${this.workerId}"`;
+            lines.push(`# HELP forge_event_loop_lag_seconds Event loop lag in seconds`);
+            lines.push(`# TYPE forge_event_loop_lag_seconds gauge`);
+            // Convert nanoseconds to seconds for consistency with other duration metrics
+            lines.push(`forge_event_loop_lag_seconds{${baseLabels},quantile="0.5"} ${(monitor.percentile(50) / 1e9).toFixed(6)}`);
+            lines.push(`forge_event_loop_lag_seconds{${baseLabels},quantile="0.95"} ${(monitor.percentile(95) / 1e9).toFixed(6)}`);
+            lines.push(`forge_event_loop_lag_seconds{${baseLabels},quantile="0.99"} ${(monitor.percentile(99) / 1e9).toFixed(6)}`);
+            lines.push(`# HELP forge_event_loop_lag_min_seconds Minimum event loop lag in seconds`);
+            lines.push(`# TYPE forge_event_loop_lag_min_seconds gauge`);
+            lines.push(`forge_event_loop_lag_min_seconds{${baseLabels}} ${(monitor.min / 1e9).toFixed(6)}`);
+            lines.push(`# HELP forge_event_loop_lag_max_seconds Maximum event loop lag in seconds`);
+            lines.push(`# TYPE forge_event_loop_lag_max_seconds gauge`);
+            lines.push(`forge_event_loop_lag_max_seconds{${baseLabels}} ${(monitor.max / 1e9).toFixed(6)}`);
+            lines.push(`# HELP forge_event_loop_lag_mean_seconds Mean event loop lag in seconds`);
+            lines.push(`# TYPE forge_event_loop_lag_mean_seconds gauge`);
+            lines.push(`forge_event_loop_lag_mean_seconds{${baseLabels}} ${(monitor.mean / 1e9).toFixed(6)}`);
+            lines.push(`# HELP forge_event_loop_lag_stddev_seconds Event loop lag standard deviation in seconds`);
+            lines.push(`# TYPE forge_event_loop_lag_stddev_seconds gauge`);
+            lines.push(`forge_event_loop_lag_stddev_seconds{${baseLabels}} ${(monitor.stddev / 1e9).toFixed(6)}`);
+            lines.push("");
+        }
+        return `${lines.join("\n")}\n`;
+    }
+    // ── Internal ──
+    _labelStr(labels) {
+        const key = JSON.stringify(labels);
+        if (_labelKeyCache.has(key))
+            return _labelKeyCache.get(key);
+        const validKeyRe = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+        const parts = [];
+        for (const k of Object.keys(labels)) {
+            const v = labels[k];
+            if (v === undefined || v === null)
+                continue;
+            // H7: Sanitize label keys
+            const safeKey = validKeyRe.test(k) ? k : k.replace(/[^a-zA-Z0-9_]/g, "_").replace(/^[^a-zA-Z_]/, "_");
+            // Truncate label values to 256 chars and escape special characters
+            const safeVal = String(v)
+                .slice(0, 256)
+                .replace(/\\/g, "\\\\")
+                .replace(/"/g, '\\"')
+                .replace(/\n/g, "\\n")
+                .replace(/\r/g, "\\r")
+                .replace(/\t/g, "\\t");
+            parts.push(`${safeKey}="${safeVal}"`);
+        }
+        const result = parts.length > 0 ? `{${parts.join(",")}}` : "";
+        // P9-fix: Evict oldest 20% when cache is full (was: stop caching entirely)
+        if (_labelKeyCache.size >= MAX_LABEL_KEY_CACHE) {
+            const evictCount = Math.ceil(MAX_LABEL_KEY_CACHE * 0.2);
+            const iter = _labelKeyCache.keys();
+            for (let i = 0; i < evictCount; i++) {
+                const k = iter.next().value;
+                if (k !== undefined)
+                    _labelKeyCache.delete(k);
+            }
+        }
+        _labelKeyCache.set(key, result);
+        return result;
+    }
+    _counterInc(name, labels = {}, value = 1) {
+        const key = `${name}${this._labelStr(labels)}`;
+        if (!this._counters.has(key) && this._counters.size >= MAX_METRIC_SERIES) {
+            if (!_seriesCapWarned) {
+                _seriesCapWarned = true;
+                console.warn(`[PrometheusMetrics] Counter series cap (${MAX_METRIC_SERIES}) reached — dropping new series`);
+            }
+            return;
+        }
+        this._counters.set(key, (this._counters.get(key) ?? 0) + value);
+    }
+    _gaugeSet(name, value, labels = {}) {
+        const key = `${name}${this._labelStr(labels)}`;
+        this._gauges.set(key, value);
+    }
+    _gaugeInc(name, labels = {}) {
+        const key = `${name}${this._labelStr(labels)}`;
+        this._gauges.set(key, (this._gauges.get(key) ?? 0) + 1);
+    }
+    _gaugeDec(name, labels = {}) {
+        const key = `${name}${this._labelStr(labels)}`;
+        const current = this._gauges.get(key) ?? 0;
+        const next = current - 1;
+        if (next < 0 && process.env.NODE_ENV !== "production") {
+            console.warn(`[forge] gauge underflow: ${name} would go negative (${current} -> ${next}), clamping to 0`);
+        }
+        this._gauges.set(key, Math.max(0, next));
+    }
+    _histogramObserve(name, value, labels = {}, buckets) {
+        const key = `${name}${this._labelStr(labels)}`;
+        let hist = this._histograms.get(key);
+        if (!hist) {
+            hist = { count: 0, sum: 0, buckets: new Array(buckets.length).fill(0), bucketBounds: buckets };
+            this._histograms.set(key, hist);
+        }
+        hist.count++;
+        hist.sum += value;
+        // P18: Early break — once value <= buckets[i], all subsequent buckets also match
+        // since buckets are sorted ascending. Increment from this point to end.
+        for (let i = 0; i < buckets.length; i++) {
+            if (value <= buckets[i]) {
+                for (let j = i; j < buckets.length; j++) {
+                    hist.buckets[j]++;
+                }
+                break;
+            }
+        }
+    }
+    /**
+     * OPS-8: Cleanup event loop monitor when metrics instance is no longer needed
+     */
+    cleanup() {
+        if (this._eventLoopMonitor) {
+            this._eventLoopMonitor.disable();
+            this._eventLoopMonitor = null;
+        }
+    }
+}
+//# sourceMappingURL=Prometheus.js.map

package/dist/core/Prometheus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prometheus.js","sourceRoot":"","sources":["../../src/core/Prometheus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,mBAAmB,GAAgB,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;AAClH,MAAM,kBAAkB,GAAgB,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAoB3F,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,GAAc;IAC/C,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzE,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IAClF,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG;QAAE,OAAO,cAAc,CAAC;IACjF,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG;QAAE,OAAO,cAAc,CAAC;IACjF,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,cAAc,CAAC;IACvD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8CAA8C;AAC9C,MAAM,cAAc,GAAwB,IAAI,GAAG,EAAE,CAAC;AACtD,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAClC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAChC,IAAI,gBAAgB,GAAG,KAAK,CAAC;AAE7B,SAAS,YAAY,CAAC,MAAc,EAAE,OAAoB;IACxD,MAAM,QAAQ,GAAW,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,iBAAiB;IAC5B,WAAW,CAAS;IACpB,QAAQ,CAAS;IACjB,SAAS,CAAS;IAClB,WAAW,CAAW;IACtB,UAAU,CAAW;IACrB,SAAS,CAAsB;IAC/B,OAAO,CAAsB;IAC7B,WAAW,CAA8B;IACzC,iBAAiB,CAAkD;IAEnE,YAAY,WAAmB,EAAE,QAAgB;QAC/C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE5B,8BAA8B;QAC9B,IAAI,CAAC,WAAW,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEpE,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAE7B,mCAAmC;QACnC,yEAAyE;QACzE,iEAAiE;QACjE,IAAI,CAAC,iBAAiB,GAAG,qBAAqB,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,6BAA6B;IAE7B,gBAAgB;QACd,IAAI,CAAC,SAAS,CAAC,4BAA4B,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,cAAc,CAAC,YAAoB,EAAE,SAAiB,EAAE;QACtD,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAC7F,IAAI,CAAC,SAAS,CAAC,4BAA4B,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,iBAAiB,CAAC,qCAAqC,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACxG,IAAI,CAAC,WAAW,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,CAAC,YAAoB,EAAE,SAAiB,EAAE;QAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAC5F,IAAI,CAAC,iBAAiB,CACpB,4BAA4B,EAC5B,YAAY,EACZ;YACE,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,GAAG,QAAQ;SACZ,EACD,IAAI,CAAC,UAAU,CAChB,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE;YAClC,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,GAAG,QAAQ;SACZ,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,SAAS,CAAC,6BAA6B,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,SAAS,CAAC,6BAA6B,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,SAAS,CAAC,YAAoB,SAAS;QACrC,IAAI,CAAC,WAAW,CAAC,yBAAyB,EAAE;YAC1C,OAAO,EAAE,IAAI,CAAC,WAAW;YACzB,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB,CAAC,MAAc,EAAE,KAAa,EAAE,QAAgB;QAC/D,IAAI,CAAC,SAAS,CAAC,yBAAyB,EAAE,KAAK,EAAE;YAC/C,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,MAAM;SACP,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,6BAA6B,EAAE,QAAQ,EAAE;YACtD,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB,CAAC,MAAc,EAAE,KAAa;QAC/C,gCAAgC;QAChC,MAAM,GAAG,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACjD,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAE7C,OAAO,CAAC,IAAY,EAAE,QAAgB,CAAC,EAAE,SAAiB,EAAE;QAC1D,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,KAAa,EAAE,SAAiB,EAAE;QACpD,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,SAAiB,EAAE,EAAE,OAAkB;QAC5E,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,EAAE,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7G,CAAC;IAED,mBAAmB;IAEnB;;OAEG;IACH,MAAM;QACJ,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,SAAS;QACT,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CACR,iCAAiC,IAAI,CAAC,WAAW,aAAa,IAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAC9H,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,WAAW;QACX,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,CAAC;YACrC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACxC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;oBAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,SAAS;QACT,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,CAAC;YACnC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACtC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;oBAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,aAAa;QACb,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,YAAY,CAAC,CAAC;YACvC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC3C,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC;oBAAE,SAAS;gBAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,MAAM,MAAM,GAAG,IAAI,CAAC;gBAEpB,eAAe;gBACf,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;gBAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;oBACtB,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC;oBACxF,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,UAAU,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClE,CAAC;gBACD,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;gBACnF,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,UAAU,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;gBACxD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC/D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,SAAS,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1D,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,kBAAkB;QAClB,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,0CAA0C,IAAI,CAAC,WAAW,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QACtF,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,oCAAoC,IAAI,CAAC,WAAW,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,gCAAgC;QAChC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC;YACvC,MAAM,UAAU,GAAG,YAAY,IAAI,CAAC,WAAW,aAAa,IAAI,CAAC,QAAQ,GAAG,CAAC;YAE7E,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;YACxD,6EAA6E;YAC7E,KAAK,CAAC,IAAI,CAAC,gCAAgC,UAAU,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACtH,KAAK,CAAC,IAAI,CAAC,gCAAgC,UAAU,qBAAqB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvH,KAAK,CAAC,IAAI,CAAC,gCAAgC,UAAU,qBAAqB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAEvH,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;YACxF,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,oCAAoC,UAAU,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAEhG,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;YACxF,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,oCAAoC,UAAU,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAEhG,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;YACtF,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAC7D,KAAK,CAAC,IAAI,CAAC,qCAAqC,UAAU,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAElG,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;YACtG,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,uCAAuC,UAAU,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACtG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACjC,CAAC;IAED,iBAAiB;IAEjB,SAAS,CAAC,MAAc;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,cAAc,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAE7D,MAAM,UAAU,GAAG,0BAA0B,CAAC;QAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;gBAAE,SAAS;YAC5C,0BAA0B;YAC1B,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YACtG,mEAAmE;YACnE,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;iBACtB,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;iBACb,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;iBACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;iBACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;iBACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;iBACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,KAAK,OAAO,GAAG,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAE9D,2EAA2E;QAC3E,IAAI,cAAc,CAAC,IAAI,IAAI,mBAAmB,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,GAAG,GAAG,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC;YACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;gBAC5B,IAAI,CAAC,KAAK,SAAS;oBAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW,CAAC,IAAY,EAAE,SAAiB,EAAE,EAAE,QAAgB,CAAC;QAC9D,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,iBAAiB,EAAE,CAAC;YACzE,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,gBAAgB,GAAG,IAAI,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,2CAA2C,iBAAiB,iCAAiC,CAAC,CAAC;YAC9G,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAClE,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,SAAiB,EAAE;QACxD,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,SAAiB,EAAE;QACzC,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,SAAiB,EAAE;QACzC,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC;QACzB,IAAI,IAAI,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,4BAA4B,IAAI,uBAAuB,OAAO,OAAO,IAAI,kBAAkB,CAAC,CAAC;QAC5G,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,iBAAiB,CAAC,IAAY,EAAE,KAAa,EAAE,SAAiB,EAAE,EAAE,OAAiB;QACnF,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,IAAI,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAa,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;YAC3G,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC;QAClB,iFAAiF;QACjF,wEAAwE;QACxE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpB,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;CACF"}