@marinoscar/platform-api 0.1.0-next.19 → 0.1.0-next.21

package/dist/alerts/alerts-context.service.js

@@ -0,0 +1,190 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var AlertContextService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertContextService = void 0;
+exports.toAlertStoreError = toAlertStoreError;
+exports.metricTablesOfSchema = metricTablesOfSchema;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../core/index");
+const index_2 = require("../jobs/index");
+const index_3 = require("../nodes/index");
+const index_4 = require("../telemetry/index");
+const alerts_errors_1 = require("./alerts.errors");
+/** Statements one rule evaluation may run. */
+const STATEMENTS_PER_EVALUATION = 5;
+const UNAVAILABLE_REASONS = new Set([
+    index_4.TELEMETRY_ERROR_REASONS.NOT_CONFIGURED,
+    index_4.TELEMETRY_ERROR_REASONS.DISABLED,
+    index_4.TELEMETRY_ERROR_REASONS.UNREACHABLE,
+    index_4.TELEMETRY_ERROR_REASONS.QUERY_TIMEOUT,
+]);
+/**
+ * Maps a telemetry failure to the evaluator's vocabulary: a store that cannot
+ * be reached is `AlertStoreUnavailableError` (the rule's incidents are left
+ * alone); anything else (a refused or failed statement) is the rule's own bug
+ * and surfaces as itself.
+ *
+ * @param error - what the telemetry slice threw.
+ * @returns the error to throw.
+ *
+ * @stability experimental
+ */
+function toAlertStoreError(error) {
+    if (error instanceof alerts_errors_1.AlertStoreUnavailableError)
+        return error;
+    if (error instanceof index_4.TelemetryHttpError && UNAVAILABLE_REASONS.has(error.reason)) {
+        return new alerts_errors_1.AlertStoreUnavailableError(describe(error), error);
+    }
+    return error;
+}
+function describe(error) {
+    if (error instanceof index_4.TelemetryHttpError) {
+        const body = error.getResponse();
+        return body?.message ?? error.message;
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Derives the metric tables of a store schema: tables with the dialect's time
+ * and value columns, and their tag columns.
+ *
+ * @param schema - the store's schema.
+ * @param dialect - the store's SQL spelling.
+ * @returns the tables by name.
+ *
+ * @stability experimental
+ */
+function metricTablesOfSchema(schema, dialect) {
+    const tables = new Map();
+    for (const table of schema.tables) {
+        const names = new Set(table.columns.map((c) => c.name));
+        if (!names.has(dialect.timestampColumn) || !names.has(dialect.valueColumn))
+            continue;
+        const reported = table.columns.some((c) => c.semanticType);
+        const tags = table.columns
+            .filter((c) => reported ? String(c.semanticType).toUpperCase() === 'TAG' : c.name !== dialect.timestampColumn && c.name !== dialect.valueColumn)
+            .map((c) => c.name)
+            .sort();
+        tables.set(table.name, { name: table.name, columns: names, tags });
+    }
+    return tables;
+}
+/**
+ * Builds the {@link AlertEvaluationContext} of one rule evaluation from the
+ * app's services. The telemetry, nodes and dashboard services are optional: a
+ * kind that needs one that is not installed gets `AlertStoreUnavailableError`.
+ *
+ * @stability experimental
+ */
+let AlertContextService = AlertContextService_1 = class AlertContextService {
+    prisma;
+    queries;
+    schema;
+    dialect;
+    dashboard;
+    lifecycle;
+    logger = new common_1.Logger(AlertContextService_1.name);
+    constructor(prisma, queries, schema, dialect, dashboard, lifecycle) {
+        this.prisma = prisma;
+        this.queries = queries;
+        this.schema = schema;
+        this.dialect = dialect;
+        this.dashboard = dashboard;
+        this.lifecycle = lifecycle;
+    }
+    /**
+     * The context for one evaluation.
+     *
+     * @param signal - aborted when the rule's time budget is spent.
+     * @param now - the instant the evaluation is for.
+     * @returns the context; its lazy members memoise per context.
+     */
+    create(signal, now = new Date()) {
+        let telemetry = null;
+        let verdict = null;
+        let stale = null;
+        return {
+            now,
+            signal,
+            db: this.prisma,
+            telemetry: () => (telemetry ??= this.openTelemetry(signal)),
+            verdict: () => (verdict ??= this.readVerdict()),
+            staleHeartbeatSeconds: () => (stale ??= this.readStale()),
+        };
+    }
+    async openTelemetry(signal) {
+        if (!this.queries || !this.schema || !this.dialect) {
+            throw new alerts_errors_1.AlertStoreUnavailableError('The telemetry slice is not installed in this application.');
+        }
+        try {
+            const schema = await this.schema.getSchema();
+            const inner = (0, index_4.createQueryFacade)(this.queries, null, {
+                source: 'alert',
+                dialect: this.dialect,
+                signal,
+                maxStatements: STATEMENTS_PER_EVALUATION,
+            });
+            const query = Object.freeze({
+                sql: inner.sql,
+                dialect: inner.dialect,
+                query: async (sql, options) => {
+                    try {
+                        return await inner.query(sql, options);
+                    }
+                    catch (error) {
+                        throw toAlertStoreError(error);
+                    }
+                },
+            });
+            return { query, tables: metricTablesOfSchema(schema, this.dialect) };
+        }
+        catch (error) {
+            throw toAlertStoreError(error);
+        }
+    }
+    async readVerdict() {
+        if (!this.dashboard)
+            throw new alerts_errors_1.AlertStoreUnavailableError('The telemetry slice is not installed in this application.');
+        try {
+            const summary = await this.dashboard.summary(null, {});
+            return { level: summary.verdict.level, reasons: summary.verdict.reasons };
+        }
+        catch (error) {
+            throw toAlertStoreError(error);
+        }
+    }
+    async readStale() {
+        if (!this.lifecycle) {
+            this.logger.debug('NodeLifecycleService is not available; using the shipped stale window.');
+            return index_2.DEFAULT_NODES_POLICY.staleHeartbeatSeconds;
+        }
+        return (await this.lifecycle.getPolicy()).staleHeartbeatSeconds;
+    }
+};
+exports.AlertContextService = AlertContextService;
+exports.AlertContextService = AlertContextService = AlertContextService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(index_1.PLATFORM_PRISMA)),
+    __param(1, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Optional)()),
+    __param(3, (0, common_1.Optional)()),
+    __param(3, (0, common_1.Inject)(index_4.TELEMETRY_SQL_DIALECT)),
+    __param(4, (0, common_1.Optional)()),
+    __param(5, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [Object, index_4.TelemetryQueryService,
+        index_4.TelemetrySchemaService, Object, index_4.TelemetryDashboardService,
+        index_3.NodeLifecycleService])
+], AlertContextService);
+//# sourceMappingURL=alerts-context.service.js.map

package/dist/alerts/alerts-context.service.js.map

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

package/dist/alerts/alerts-dispatch.service.d.ts

@@ -0,0 +1,53 @@
+import { ConfigService } from '@nestjs/config';
+import { NotificationsService } from '../notifications/index';
+import { AlertsMetrics } from './alerts.metrics';
+import type { AlertsWebhookEmitter } from './alerts.types';
+import type { AlertIncidentRow, AlertRuleRow } from './data/alerts-db';
+/**
+ * One webhook event the slice emits.
+ *
+ * @stability experimental
+ */
+export interface AlertWebhookEventDef {
+    /** The event key. */
+    readonly key: string;
+    /** The label a webhooks catalog shows. */
+    readonly label: string;
+    /** One sentence on when it is emitted. */
+    readonly description: string;
+}
+/**
+ * The webhook event keys the slice emits, with the labels a webhooks slice
+ * shows in its catalog.
+ *
+ * @stability experimental
+ */
+export declare const ALERT_WEBHOOK_EVENT_DEFS: readonly AlertWebhookEventDef[];
+/**
+ * Sends the two things a fired or resolved incident causes: the notification
+ * to the holders of `alerts:read` and the optional webhook. Called AFTER the
+ * incident write committed (the evaluator never opens a transaction), and it
+ * never throws: a failed dispatch is logged and the incident stands.
+ *
+ * @stability experimental
+ */
+export declare class AlertsDispatchService {
+    private readonly metrics;
+    private readonly notifications?;
+    private readonly webhooks?;
+    private readonly config?;
+    private readonly logger;
+    constructor(metrics: AlertsMetrics, notifications?: NotificationsService | undefined, webhooks?: AlertsWebhookEmitter | undefined, config?: ConfigService | undefined);
+    /**
+     * Dispatches one transition.
+     *
+     * @param to - `fired` or `resolved`.
+     * @param rule - the rule.
+     * @param incident - the incident as just written.
+     * @param notify - whether the notification is sent (false inside a cooldown); the webhook and the metric follow the transition regardless.
+     */
+    dispatch(to: 'fired' | 'resolved', rule: AlertRuleRow, incident: AlertIncidentRow, notify: boolean): Promise<void>;
+    private notify;
+    private emitWebhook;
+}
+//# sourceMappingURL=alerts-dispatch.service.d.ts.map

package/dist/alerts/alerts-dispatch.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-dispatch.service.d.ts","sourceRoot":"","sources":["../../src/alerts/alerts-dispatch.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAM9D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGvE;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,oBAAoB,EAGnE,CAAC;AAOF;;;;;;;GAOG;AACH,qBACa,qBAAqB;IAI9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACZ,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IACC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IANtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAG9C,OAAO,EAAE,aAAa,EACV,aAAa,CAAC,EAAE,oBAAoB,YAAA,EACJ,QAAQ,CAAC,EAAE,oBAAoB,YAAA,EAC/D,MAAM,CAAC,EAAE,aAAa,YAAA;IASrD;;;;;;;OAOG;IACG,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxH,OAAO,CAAC,MAAM;YAgCA,WAAW;CAiB1B"}

package/dist/alerts/alerts-dispatch.service.js

@@ -0,0 +1,135 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var AlertsDispatchService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertsDispatchService = exports.ALERT_WEBHOOK_EVENT_DEFS = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const alerts_1 = require("@marinoscar/platform-contract/alerts");
+const index_1 = require("../notifications/index");
+const alerts_constants_1 = require("./alerts.constants");
+const alerts_metrics_1 = require("./alerts.metrics");
+/**
+ * The webhook event keys the slice emits, with the labels a webhooks slice
+ * shows in its catalog.
+ *
+ * @stability experimental
+ */
+exports.ALERT_WEBHOOK_EVENT_DEFS = [
+    { key: alerts_1.ALERT_WEBHOOK_EVENTS.FIRED, label: 'Alert fired', description: 'An alert rule started firing.' },
+    { key: alerts_1.ALERT_WEBHOOK_EVENTS.RESOLVED, label: 'Alert resolved', description: 'A firing alert cleared.' },
+];
+function labelsOf(incident) {
+    const raw = incident.labels;
+    return raw && typeof raw === 'object' ? raw : {};
+}
+/**
+ * Sends the two things a fired or resolved incident causes: the notification
+ * to the holders of `alerts:read` and the optional webhook. Called AFTER the
+ * incident write committed (the evaluator never opens a transaction), and it
+ * never throws: a failed dispatch is logged and the incident stands.
+ *
+ * @stability experimental
+ */
+let AlertsDispatchService = AlertsDispatchService_1 = class AlertsDispatchService {
+    metrics;
+    notifications;
+    webhooks;
+    config;
+    logger = new common_1.Logger(AlertsDispatchService_1.name);
+    constructor(metrics, notifications, webhooks, config) {
+        this.metrics = metrics;
+        this.notifications = notifications;
+        this.webhooks = webhooks;
+        this.config = config;
+        try {
+            this.webhooks?.registerEvents?.(exports.ALERT_WEBHOOK_EVENT_DEFS);
+        }
+        catch (error) {
+            this.logger.warn(`The webhook emitter refused the alert events: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Dispatches one transition.
+     *
+     * @param to - `fired` or `resolved`.
+     * @param rule - the rule.
+     * @param incident - the incident as just written.
+     * @param notify - whether the notification is sent (false inside a cooldown); the webhook and the metric follow the transition regardless.
+     */
+    async dispatch(to, rule, incident, notify) {
+        this.metrics.transition(to, incident.severity);
+        if (notify)
+            this.notify(to, rule, incident);
+        await this.emitWebhook(to, rule, incident);
+    }
+    notify(to, rule, incident) {
+        if (!this.notifications)
+            return;
+        try {
+            const appUrl = this.config?.get('appUrl');
+            const data = {
+                incidentId: incident.id,
+                ruleId: rule.id,
+                ruleName: rule.name,
+                severity: incident.severity,
+                state: to,
+                summary: incident.summary,
+                labels: labelsOf(incident),
+                value: incident.lastValue,
+                firedAt: incident.firedAt,
+                resolvedAt: incident.resolvedAt,
+                ...(appUrl ? { appUrl: appUrl.replace(/\/+$/, '') } : {}),
+            };
+            void this.notifications
+                .notifyPermissionHolders(to === 'fired' ? alerts_constants_1.ALERT_FIRED_NOTIFICATION : alerts_constants_1.ALERT_RESOLVED_NOTIFICATION, alerts_1.ALERT_PERMISSIONS.READ, data, rule.notifyChannels.length > 0 ? { channels: rule.notifyChannels } : undefined)
+                .catch((error) => {
+                this.logger.error(`Dispatching the '${to}' alert notification for incident ${incident.id} rejected: ${error instanceof Error ? error.message : String(error)}`);
+            });
+        }
+        catch (error) {
+            this.logger.error(`Could not raise the '${to}' alert notification for incident ${incident.id}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async emitWebhook(to, rule, incident) {
+        if (!this.webhooks || !rule.webhook)
+            return;
+        try {
+            const data = {
+                incidentId: incident.id,
+                rule: { id: rule.id, key: rule.key, name: rule.name, kind: rule.kind, severity: rule.severity },
+                labels: labelsOf(incident),
+                value: incident.lastValue,
+                summary: incident.summary,
+                firedAt: incident.firedAt ? incident.firedAt.toISOString() : null,
+                resolvedAt: incident.resolvedAt ? incident.resolvedAt.toISOString() : null,
+            };
+            await this.webhooks.emit(to === 'fired' ? alerts_1.ALERT_WEBHOOK_EVENTS.FIRED : alerts_1.ALERT_WEBHOOK_EVENTS.RESOLVED, data, { orgId: null });
+        }
+        catch (error) {
+            this.logger.error(`Could not emit the '${to}' alert webhook for incident ${incident.id}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+};
+exports.AlertsDispatchService = AlertsDispatchService;
+exports.AlertsDispatchService = AlertsDispatchService = AlertsDispatchService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)(alerts_constants_1.ALERTS_WEBHOOK_EMITTER)),
+    __param(3, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [alerts_metrics_1.AlertsMetrics,
+        index_1.NotificationsService, Object, config_1.ConfigService])
+], AlertsDispatchService);
+//# sourceMappingURL=alerts-dispatch.service.js.map

package/dist/alerts/alerts-dispatch.service.js.map

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

package/dist/alerts/alerts-evaluation.service.d.ts

@@ -0,0 +1,88 @@
+import type { AlertObservation } from '@marinoscar/platform-contract/alerts';
+import { AlertContextService } from './alerts-context.service';
+import { AlertsDispatchService } from './alerts-dispatch.service';
+import type { ResolvedAlertsModuleOptions } from './alerts.options';
+import type { AlertNodeEventPayload } from './alerts.types';
+import type { AlertRuleRow, AlertsPrisma } from './data/alerts-db';
+/**
+ * What one rule's evaluation did.
+ *
+ * @stability experimental
+ */
+export interface AlertEvaluationOutcome {
+    /** The rule. */
+    readonly ruleId: string;
+    /** `ok`, or `error` (the kind failed, timed out or is not registered; incidents were left alone). */
+    readonly status: 'ok' | 'error';
+    /** The error message when `status` is `error`. */
+    readonly error: string | null;
+    /** Incidents created. */
+    readonly opened: number;
+    /** Incidents that moved to firing (now or on creation). */
+    readonly fired: number;
+    /** Incidents that resolved. */
+    readonly resolved: number;
+}
+/**
+ * Whether `error` is a unique-constraint violation (Prisma `P2002`).
+ *
+ * @param error - what a write threw.
+ * @returns whether it is `P2002`.
+ *
+ * @stability experimental
+ */
+export declare function isUniqueViolation(error: unknown): boolean;
+/**
+ * Runs the enabled rules: evaluates each kind, isolates failures per rule,
+ * then applies the state machine to the observations. Evaluation is
+ * IDEMPOTENT: two passes over the same data leave one incident (the partial
+ * unique index arbitrates a race), and every state change is a conditional
+ * write so a concurrent pass cannot dispatch the same transition twice.
+ *
+ * It never opens a transaction, so a dispatch always follows a committed write.
+ *
+ * @stability experimental
+ */
+export declare class AlertsEvaluationService {
+    private readonly prisma;
+    private readonly contexts;
+    private readonly dispatcher;
+    private readonly options;
+    private readonly logger;
+    constructor(prisma: AlertsPrisma, contexts: AlertContextService, dispatcher: AlertsDispatchService, options: ResolvedAlertsModuleOptions);
+    /**
+     * Evaluates every enabled rule (or only the event-driven ones that `event`
+     * can change).
+     *
+     * @param scope - `{ event }` restricts to rules of event-driven kinds whose kind says the event matters.
+     * @returns one outcome per rule evaluated.
+     */
+    evaluateEnabled(scope?: {
+        event?: AlertNodeEventPayload;
+    }): Promise<AlertEvaluationOutcome[]>;
+    /**
+     * Evaluates one rule and applies its observations. Never throws: a failure
+     * is recorded on the rule (`lastError`) and returned.
+     *
+     * @param rule - the rule row.
+     * @param now - the instant (a test seam).
+     * @returns what happened.
+     */
+    evaluateRule(rule: AlertRuleRow, now?: Date): Promise<AlertEvaluationOutcome>;
+    /**
+     * Evaluates a rule WITHOUT touching state or dispatching: the dry run behind
+     * `POST /rules/:id/test`.
+     *
+     * @param rule - the rule row.
+     * @param now - the instant.
+     * @returns the observations.
+     * @throws whatever the kind throws (the caller reports it).
+     */
+    observe(rule: AlertRuleRow, now?: Date): Promise<AlertObservation[]>;
+    private stamp;
+    private apply;
+    private create;
+    private fired;
+    private previousResolvedAt;
+}
+//# sourceMappingURL=alerts-evaluation.service.d.ts.map

package/dist/alerts/alerts-evaluation.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-evaluation.service.d.ts","sourceRoot":"","sources":["../../src/alerts/alerts-evaluation.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAiB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EAAoB,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIrF;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qGAAqG;IACrG,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAUD;;;;;;;;;;GAUG;AACH,qBACa,uBAAuB;IAIP,OAAO,CAAC,QAAQ,CAAC,MAAM;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO;IANlD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;gBAGvB,MAAM,EAAE,YAAY,EAC7C,QAAQ,EAAE,mBAAmB,EAC7B,UAAU,EAAE,qBAAqB,EACT,OAAO,EAAE,2BAA2B;IAG/E;;;;;;OAMG;IACG,eAAe,CAAC,KAAK,GAAE;QAAE,KAAK,CAAC,EAAE,qBAAqB,CAAA;KAAO,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAgBvG;;;;;;;OAOG;IACG,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAyB/F;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;YA6BlE,KAAK;YAQL,KAAK;YAyFL,MAAM;YA4BN,KAAK;YAKL,kBAAkB;CAQjC"}