@cyanheads/mcp-ts-core 0.1.0-beta.12

package/dist/utils/security/sanitization.js.map

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

package/dist/utils/telemetry/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Barrel for telemetry utilities.
+ * Provides OpenTelemetry instrumentation, semantic conventions, trace helpers,
+ * and metrics creation utilities for comprehensive observability.
+ *
+ * @module src/utils/telemetry
+ */
+export * from './instrumentation.js';
+export * from './metrics.js';
+export * from './semconv.js';
+export * from './trace.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/utils/telemetry/index.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Barrel for telemetry utilities.
+ * Provides OpenTelemetry instrumentation, semantic conventions, trace helpers,
+ * and metrics creation utilities for comprehensive observability.
+ *
+ * @module src/utils/telemetry
+ */
+export * from './instrumentation.js';
+export * from './metrics.js';
+export * from './semconv.js';
+export * from './trace.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/utils/telemetry/instrumentation.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview OpenTelemetry SDK initialization and lifecycle management.
+ * Provides runtime-aware initialization with graceful degradation for Worker/Edge environments.
+ * Supports both Node.js (full NodeSDK) and serverless runtimes (lightweight telemetry).
+ * @module src/utils/telemetry/instrumentation
+ */
+import type { NodeSDK } from '@opentelemetry/sdk-node';
+/**
+ * The active OpenTelemetry `NodeSDK` instance, or `null` when telemetry is disabled,
+ * the runtime is not Node/Bun, or the SDK has been shut down.
+ * Node-specific SDK modules are lazy-loaded inside `initializeOpenTelemetry` to prevent
+ * crashes in Worker/Edge environments where those modules are unavailable.
+ */
+export declare let sdk: NodeSDK | null;
+/**
+ * Initializes the OpenTelemetry SDK with runtime-appropriate configuration.
+ * Idempotent — safe to call multiple times; subsequent calls return the existing promise or resolve immediately.
+ * No-ops silently when telemetry is disabled (`OTEL_ENABLED=false`) or when running in a
+ * Worker/Edge environment where `NodeSDK` is unavailable.
+ *
+ * In Node/Bun environments, all SDK modules (`@opentelemetry/sdk-node`, exporters,
+ * auto-instrumentations) are **lazy-loaded** via `Promise.all(import(...))` to prevent
+ * Worker bundle failures.
+ *
+ * Configures:
+ * - OTLP trace exporter + `BatchSpanProcessor` (when `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` is set)
+ * - OTLP metrics exporter + `PeriodicExportingMetricReader` at 15 s intervals (when `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` is set)
+ * - `TraceIdRatioBasedSampler` using `config.openTelemetry.samplingRatio`
+ * - Node auto-instrumentations (HTTP enabled, FS disabled)
+ * - Pino instrumentation that injects `trace_id`/`span_id` into log records
+ * - Cloud resource attributes via `detectCloudResource()`
+ *
+ * @returns Promise that resolves when initialization is complete (or was already complete)
+ * @throws Error if `NodeSDK.start()` or any lazy import fails; re-thrown after resetting `sdk` to `null`
+ *
+ * @example
+ * ```typescript
+ * // In application entry point (src/index.ts)
+ * await initializeOpenTelemetry();
+ * ```
+ */
+export declare function initializeOpenTelemetry(): Promise<void>;
+/**
+ * Gracefully shuts down the OpenTelemetry SDK with timeout protection.
+ * This function is called during the application's shutdown sequence.
+ * Prevents hung processes by racing shutdown against a timeout.
+ *
+ * @param timeoutMs - Maximum time to wait for shutdown in milliseconds (default: 5000)
+ * @throws Error if shutdown times out or fails critically
+ *
+ * @example
+ * ```typescript
+ * // During application shutdown
+ * try {
+ *   await shutdownOpenTelemetry();
+ * } catch (error) {
+ *   console.error('Failed to shutdown telemetry:', error);
+ * }
+ * ```
+ */
+export declare function shutdownOpenTelemetry(timeoutMs?: number): Promise<void>;
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/utils/telemetry/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAKvD;;;;;GAKG;AACH,eAAO,IAAI,GAAG,EAAE,OAAO,GAAG,IAAW,CAAC;AA0DtC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwH7D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3E"}

package/dist/utils/telemetry/instrumentation.js

@@ -0,0 +1,223 @@
+/**
+ * @fileoverview OpenTelemetry SDK initialization and lifecycle management.
+ * Provides runtime-aware initialization with graceful degradation for Worker/Edge environments.
+ * Supports both Node.js (full NodeSDK) and serverless runtimes (lightweight telemetry).
+ * @module src/utils/telemetry/instrumentation
+ */
+import { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';
+import { config } from '../../config/index.js';
+import { runtimeCaps } from '../../utils/internal/runtime.js';
+/**
+ * The active OpenTelemetry `NodeSDK` instance, or `null` when telemetry is disabled,
+ * the runtime is not Node/Bun, or the SDK has been shut down.
+ * Node-specific SDK modules are lazy-loaded inside `initializeOpenTelemetry` to prevent
+ * crashes in Worker/Edge environments where those modules are unavailable.
+ */
+export let sdk = null;
+// Initialization state management
+let isOtelInitialized = false;
+let initializationPromise = null;
+/**
+ * Determines if the NodeSDK can be used in the current runtime.
+ * Returns false in Worker/Edge environments where Node modules are unavailable.
+ * Bun is allowed — auto-instrumentations that rely on Node http hooks silently
+ * no-op, but manual spans, custom metrics, and OTLP export all work correctly.
+ */
+function canUseNodeSDK() {
+    return (runtimeCaps.isNode &&
+        typeof process?.versions?.node === 'string' &&
+        typeof process.env === 'object');
+}
+/**
+ * Detects cloud platform and provider for resource attributes.
+ * Enriches telemetry with deployment environment metadata.
+ *
+ * @returns Record of cloud-related resource attributes
+ */
+function detectCloudResource() {
+    const attrs = {};
+    // Cloudflare Workers
+    if (runtimeCaps.isWorkerLike) {
+        attrs['cloud.provider'] = 'cloudflare';
+        attrs['cloud.platform'] = 'cloudflare_workers';
+    }
+    // AWS Lambda
+    if (typeof process !== 'undefined' && process.env?.AWS_LAMBDA_FUNCTION_NAME) {
+        attrs['cloud.provider'] = 'aws';
+        attrs['cloud.platform'] = 'aws_lambda';
+        if (process.env.AWS_REGION) {
+            attrs['cloud.region'] = process.env.AWS_REGION;
+        }
+    }
+    // GCP Cloud Functions/Cloud Run
+    if (typeof process !== 'undefined' && (process.env?.FUNCTION_TARGET || process.env?.K_SERVICE)) {
+        attrs['cloud.provider'] = 'gcp';
+        attrs['cloud.platform'] = process.env.FUNCTION_TARGET ? 'gcp_cloud_functions' : 'gcp_cloud_run';
+        if (process.env.GCP_REGION) {
+            attrs['cloud.region'] = process.env.GCP_REGION;
+        }
+    }
+    attrs['deployment.environment.name'] = config.environment;
+    return attrs;
+}
+/**
+ * Initializes the OpenTelemetry SDK with runtime-appropriate configuration.
+ * Idempotent — safe to call multiple times; subsequent calls return the existing promise or resolve immediately.
+ * No-ops silently when telemetry is disabled (`OTEL_ENABLED=false`) or when running in a
+ * Worker/Edge environment where `NodeSDK` is unavailable.
+ *
+ * In Node/Bun environments, all SDK modules (`@opentelemetry/sdk-node`, exporters,
+ * auto-instrumentations) are **lazy-loaded** via `Promise.all(import(...))` to prevent
+ * Worker bundle failures.
+ *
+ * Configures:
+ * - OTLP trace exporter + `BatchSpanProcessor` (when `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` is set)
+ * - OTLP metrics exporter + `PeriodicExportingMetricReader` at 15 s intervals (when `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` is set)
+ * - `TraceIdRatioBasedSampler` using `config.openTelemetry.samplingRatio`
+ * - Node auto-instrumentations (HTTP enabled, FS disabled)
+ * - Pino instrumentation that injects `trace_id`/`span_id` into log records
+ * - Cloud resource attributes via `detectCloudResource()`
+ *
+ * @returns Promise that resolves when initialization is complete (or was already complete)
+ * @throws Error if `NodeSDK.start()` or any lazy import fails; re-thrown after resetting `sdk` to `null`
+ *
+ * @example
+ * ```typescript
+ * // In application entry point (src/index.ts)
+ * await initializeOpenTelemetry();
+ * ```
+ */
+export async function initializeOpenTelemetry() {
+    // Return existing promise if initialization in progress
+    if (initializationPromise) {
+        return await initializationPromise;
+    }
+    // Already initialized
+    if (isOtelInitialized) {
+        return;
+    }
+    initializationPromise = (async () => {
+        if (!config.openTelemetry.enabled) {
+            diag.info('OpenTelemetry disabled via configuration.');
+            isOtelInitialized = true;
+            return;
+        }
+        if (!canUseNodeSDK()) {
+            diag.info('NodeSDK unavailable in this runtime. Using lightweight telemetry mode.');
+            isOtelInitialized = true;
+            return;
+        }
+        isOtelInitialized = true;
+        try {
+            // Lazy-load Node-specific modules
+            const [{ getNodeAutoInstrumentations }, { OTLPMetricExporter }, { OTLPTraceExporter }, { PinoInstrumentation }, { resourceFromAttributes }, { PeriodicExportingMetricReader }, { NodeSDK }, { BatchSpanProcessor, TraceIdRatioBasedSampler }, { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION },] = await Promise.all([
+                import('@opentelemetry/auto-instrumentations-node'),
+                import('@opentelemetry/exporter-metrics-otlp-http'),
+                import('@opentelemetry/exporter-trace-otlp-http'),
+                import('@opentelemetry/instrumentation-pino'),
+                import('@opentelemetry/resources'),
+                import('@opentelemetry/sdk-metrics'),
+                import('@opentelemetry/sdk-node'),
+                import('@opentelemetry/sdk-trace-node'),
+                import('@opentelemetry/semantic-conventions/incubating'),
+            ]);
+            const otelLogLevelString = config.openTelemetry.logLevel.toUpperCase();
+            const otelLogLevel = DiagLogLevel[otelLogLevelString] ?? DiagLogLevel.INFO;
+            diag.setLogger(new DiagConsoleLogger(), otelLogLevel);
+            const tracesEndpoint = config.openTelemetry.tracesEndpoint;
+            const metricsEndpoint = config.openTelemetry.metricsEndpoint;
+            if (!tracesEndpoint && !metricsEndpoint) {
+                diag.warn('OTEL_ENABLED is true, but no OTLP endpoint for traces or metrics is configured. OpenTelemetry will not export any telemetry.');
+            }
+            const resource = resourceFromAttributes({
+                [ATTR_SERVICE_NAME]: config.openTelemetry.serviceName,
+                [ATTR_SERVICE_VERSION]: config.openTelemetry.serviceVersion,
+                ...detectCloudResource(),
+            });
+            const spanProcessors = [];
+            if (tracesEndpoint) {
+                diag.info(`Using OTLP exporter for traces, endpoint: ${tracesEndpoint}`);
+                const traceExporter = new OTLPTraceExporter({ url: tracesEndpoint });
+                spanProcessors.push(new BatchSpanProcessor(traceExporter));
+            }
+            else {
+                diag.info('No OTLP traces endpoint configured. Traces will not be exported.');
+            }
+            const metricReader = metricsEndpoint
+                ? new PeriodicExportingMetricReader({
+                    exporter: new OTLPMetricExporter({ url: metricsEndpoint }),
+                    exportIntervalMillis: 15000,
+                })
+                : undefined;
+            sdk = new NodeSDK({
+                resource,
+                spanProcessors,
+                ...(metricReader && { metricReader }),
+                sampler: new TraceIdRatioBasedSampler(config.openTelemetry.samplingRatio),
+                instrumentations: [
+                    getNodeAutoInstrumentations({
+                        '@opentelemetry/instrumentation-http': {
+                            enabled: true,
+                            ignoreIncomingRequestHook: (req) => req.url === '/healthz',
+                        },
+                        '@opentelemetry/instrumentation-fs': { enabled: false },
+                    }),
+                    new PinoInstrumentation({
+                        logHook: (_span, record) => {
+                            record.trace_id = _span.spanContext().traceId;
+                            record.span_id = _span.spanContext().spanId;
+                        },
+                    }),
+                ],
+            });
+            sdk.start();
+            diag.info(`OpenTelemetry NodeSDK initialized for ${config.openTelemetry.serviceName} v${config.openTelemetry.serviceVersion}`);
+        }
+        catch (error) {
+            diag.error('Error initializing OpenTelemetry', error);
+            sdk = null;
+            throw error;
+        }
+    })();
+    return initializationPromise;
+}
+/**
+ * Gracefully shuts down the OpenTelemetry SDK with timeout protection.
+ * This function is called during the application's shutdown sequence.
+ * Prevents hung processes by racing shutdown against a timeout.
+ *
+ * @param timeoutMs - Maximum time to wait for shutdown in milliseconds (default: 5000)
+ * @throws Error if shutdown times out or fails critically
+ *
+ * @example
+ * ```typescript
+ * // During application shutdown
+ * try {
+ *   await shutdownOpenTelemetry();
+ * } catch (error) {
+ *   console.error('Failed to shutdown telemetry:', error);
+ * }
+ * ```
+ */
+export async function shutdownOpenTelemetry(timeoutMs = 5000) {
+    if (!sdk) {
+        return;
+    }
+    try {
+        const shutdownPromise = sdk.shutdown();
+        const { promise: timeoutPromise, reject } = Promise.withResolvers();
+        setTimeout(() => reject(new Error('OpenTelemetry SDK shutdown timeout')), timeoutMs);
+        await Promise.race([shutdownPromise, timeoutPromise]);
+        diag.info('OpenTelemetry SDK terminated successfully.');
+    }
+    catch (error) {
+        diag.error('Error terminating OpenTelemetry SDK', error);
+        throw error; // Propagate for caller handling
+    }
+    finally {
+        sdk = null;
+        isOtelInitialized = false;
+        initializationPromise = null;
+    }
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/utils/telemetry/instrumentation.js.map

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

package/dist/utils/telemetry/metrics.d.ts

@@ -0,0 +1,170 @@
+/**
+ * @fileoverview OpenTelemetry metrics utilities for custom instrumentation.
+ * Provides simplified interfaces for creating and managing counters, histograms,
+ * gauges, and observable metrics. Supports both Node and Worker environments.
+ * @module src/utils/telemetry/metrics
+ */
+import { type Counter, type Histogram, type Meter, type ObservableGauge } from '@opentelemetry/api';
+/**
+ * Gets or creates a meter for custom metrics.
+ * Uses application service name and version from config by default.
+ *
+ * @param name - Optional custom meter name (defaults to service name)
+ * @returns Meter instance for creating metrics
+ *
+ * @example
+ * ```typescript
+ * const meter = getMeter('database-metrics');
+ * const queryCounter = meter.createCounter('db.queries');
+ * ```
+ */
+export declare function getMeter(name?: string): Meter;
+/**
+ * Creates a counter metric (monotonically increasing).
+ * Counters are suitable for measuring event counts, request totals, errors, etc.
+ *
+ * @param name - Metric name (should use dot notation, e.g., 'http.requests')
+ * @param description - Human-readable description of what the metric measures
+ * @param unit - Optional unit of measurement (e.g., '1', 'requests', 'bytes')
+ * @returns Counter instance for recording values
+ *
+ * @example
+ * ```typescript
+ * const requestCounter = createCounter(
+ *   'api.requests',
+ *   'Total number of API requests',
+ *   '1'
+ * );
+ *
+ * // Later in code
+ * requestCounter.add(1, {
+ *   'http.method': 'GET',
+ *   'http.route': '/api/users'
+ * });
+ * ```
+ */
+export declare function createCounter(name: string, description: string, unit?: string): Counter;
+/**
+ * Creates an up-down counter metric (can increase or decrease).
+ * Suitable for tracking values that fluctuate, like active connections or queue depth.
+ *
+ * @param name - Metric name (should use dot notation, e.g., 'connections.active')
+ * @param description - Human-readable description of what the metric measures
+ * @param unit - Optional unit of measurement (default: '1')
+ * @returns UpDownCounter instance for recording positive and negative deltas
+ *
+ * @example
+ * ```typescript
+ * const activeConnections = createUpDownCounter(
+ *   'connections.active',
+ *   'Number of active connections',
+ *   '{connections}'
+ * );
+ *
+ * activeConnections.add(1);  // New connection
+ * activeConnections.add(-1); // Connection closed
+ * ```
+ */
+export declare function createUpDownCounter(name: string, description: string, unit?: string): import("@opentelemetry/api").UpDownCounter<import("@opentelemetry/api").Attributes>;
+/**
+ * Creates a histogram metric for recording distributions.
+ * Histograms are ideal for latency, response times, payload sizes, etc.
+ *
+ * @param name - Metric name (should use dot notation)
+ * @param description - Human-readable description
+ * @param unit - Optional unit (e.g., 'ms', 'bytes', 's')
+ * @returns Histogram instance
+ *
+ * @example
+ * ```typescript
+ * const requestDuration = createHistogram(
+ *   'http.request.duration',
+ *   'HTTP request duration',
+ *   'ms'
+ * );
+ *
+ * const startTime = Date.now();
+ * // ... handle request ...
+ * requestDuration.record(Date.now() - startTime, {
+ *   'http.method': 'POST',
+ *   'http.status_code': 200
+ * });
+ * ```
+ */
+export declare function createHistogram(name: string, description: string, unit?: string): Histogram;
+/**
+ * Creates an observable gauge for async/callback-based measurements.
+ * Gauges are polled periodically by the metrics SDK and report current values.
+ * Use for measuring things like memory usage, queue depth, temperature, etc.
+ *
+ * @param name - Metric name (should use dot notation)
+ * @param description - Human-readable description
+ * @param callback - Async function returning the current metric value
+ * @param unit - Optional unit of measurement
+ * @returns ObservableGauge instance
+ *
+ * @example
+ * ```typescript
+ * // Monitor heap memory usage
+ * createObservableGauge(
+ *   'process.memory.heap_used',
+ *   'Current heap memory usage',
+ *   () => {
+ *     if (typeof process !== 'undefined') {
+ *       return process.memoryUsage().heapUsed;
+ *     }
+ *     return 0;
+ *   },
+ *   'bytes'
+ * );
+ * ```
+ */
+export declare function createObservableGauge(name: string, description: string, callback: () => Promise<number> | number, unit?: string): ObservableGauge;
+/**
+ * Creates an observable counter for async/callback-based cumulative measurements.
+ * Similar to ObservableGauge but for monotonically increasing values.
+ * The callback is registered via `addCallback` and polled by the metrics SDK on each collection cycle.
+ *
+ * @param name - Metric name (should use dot notation, e.g., 'jobs.processed')
+ * @param description - Human-readable description
+ * @param callback - Async function returning the current cumulative count
+ * @param unit - Optional unit of measurement (default: '1')
+ * @returns ObservableCounter instance
+ *
+ * @example
+ * ```typescript
+ * let totalProcessed = 0;
+ *
+ * createObservableCounter(
+ *   'jobs.processed',
+ *   'Total jobs processed since startup',
+ *   () => totalProcessed,
+ *   '{jobs}'
+ * );
+ * ```
+ */
+export declare function createObservableCounter(name: string, description: string, callback: () => Promise<number> | number, unit?: string): import("@opentelemetry/api").ObservableCounter<import("@opentelemetry/api").Attributes>;
+/**
+ * Creates an observable up-down counter for async/callback-based measurements
+ * that can increase or decrease.
+ * The callback is registered via `addCallback` and polled by the metrics SDK on each collection cycle.
+ *
+ * @param name - Metric name (should use dot notation, e.g., 'queue.size')
+ * @param description - Human-readable description of what the metric measures
+ * @param callback - Async function returning the current value (can be positive or negative)
+ * @param unit - Optional unit of measurement (default: '1')
+ * @returns ObservableUpDownCounter instance
+ *
+ * @example
+ * ```typescript
+ * // Track current queue size
+ * createObservableUpDownCounter(
+ *   'queue.size',
+ *   'Current number of items in queue',
+ *   async () => await getQueueSize(),
+ *   '{items}'
+ * );
+ * ```
+ */
+export declare function createObservableUpDownCounter(name: string, description: string, callback: () => Promise<number> | number, unit?: string): import("@opentelemetry/api").ObservableUpDownCounter<import("@opentelemetry/api").Attributes>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/utils/telemetry/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,KAAK,EAEV,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAI5B;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAK7C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,OAAO,CAGpF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,SAAM,uFAGhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAI3F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EACxC,IAAI,CAAC,EAAE,MAAM,GACZ,eAAe,CAQjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EACxC,IAAI,SAAM,2FAQX;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EACxC,IAAI,SAAM,iGAQX"}