@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.3

package/dist/otel-core/index.js

@@ -0,0 +1,58 @@
+"use strict";
+// `@marinoscar/platform-api/otel-core`: the emitting half of telemetry
+// (issue #700). The metrics host and its name registry, label bounding, the
+// gauge-provider seam, the request span attributes hook, `@Trace()`, and the
+// Nest-free `sdk` half re-exported. Documented in ./README.md.
+//
+// Import `@marinoscar/platform-api/otel-core/sdk`, never this index, from the
+// file that installs the SDK: this one loads `@nestjs/common`.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Trace = exports.requestSpanAttributesHook = exports.registerRequestSpanAttributes = exports.hasBearer = exports.ATTR_HTTP_ROUTE = exports.ATTR_APP_ROUTE_MATCHED = exports.ATTR_APP_REQUEST_BEARER = exports.OtelMetricsModule = exports.MetricsHostService = exports.METRICS_HOST_OPTIONS = exports.APP_METER_NAME = exports.createRegisteredGauge = exports.shapeLabel = exports.nonNegative = exports.enumLabel = exports.UNKNOWN_LABEL = exports.OTHER_LABEL = exports.MAX_DISTINCT_VALUES = exports.LabelBudget = exports.registerAppMetrics = exports.assertAppMetric = exports.appMetricRegistry = exports.APP_METRIC_NAME_PATTERN = exports.APP_METRIC_KEY_PATTERN = exports.APP_METRIC_ATTRIBUTE_KEY_PATTERN = void 0;
+__exportStar(require("./sdk/index"), exports);
+var metric_name_registry_1 = require("./metrics/metric-name.registry");
+Object.defineProperty(exports, "APP_METRIC_ATTRIBUTE_KEY_PATTERN", { enumerable: true, get: function () { return metric_name_registry_1.APP_METRIC_ATTRIBUTE_KEY_PATTERN; } });
+Object.defineProperty(exports, "APP_METRIC_KEY_PATTERN", { enumerable: true, get: function () { return metric_name_registry_1.APP_METRIC_KEY_PATTERN; } });
+Object.defineProperty(exports, "APP_METRIC_NAME_PATTERN", { enumerable: true, get: function () { return metric_name_registry_1.APP_METRIC_NAME_PATTERN; } });
+Object.defineProperty(exports, "appMetricRegistry", { enumerable: true, get: function () { return metric_name_registry_1.appMetricRegistry; } });
+Object.defineProperty(exports, "assertAppMetric", { enumerable: true, get: function () { return metric_name_registry_1.assertAppMetric; } });
+Object.defineProperty(exports, "registerAppMetrics", { enumerable: true, get: function () { return metric_name_registry_1.registerAppMetrics; } });
+var labels_1 = require("./metrics/labels");
+Object.defineProperty(exports, "LabelBudget", { enumerable: true, get: function () { return labels_1.LabelBudget; } });
+Object.defineProperty(exports, "MAX_DISTINCT_VALUES", { enumerable: true, get: function () { return labels_1.MAX_DISTINCT_VALUES; } });
+Object.defineProperty(exports, "OTHER_LABEL", { enumerable: true, get: function () { return labels_1.OTHER_LABEL; } });
+Object.defineProperty(exports, "UNKNOWN_LABEL", { enumerable: true, get: function () { return labels_1.UNKNOWN_LABEL; } });
+Object.defineProperty(exports, "enumLabel", { enumerable: true, get: function () { return labels_1.enumLabel; } });
+Object.defineProperty(exports, "nonNegative", { enumerable: true, get: function () { return labels_1.nonNegative; } });
+Object.defineProperty(exports, "shapeLabel", { enumerable: true, get: function () { return labels_1.shapeLabel; } });
+var gauge_provider_1 = require("./metrics/gauge-provider");
+Object.defineProperty(exports, "createRegisteredGauge", { enumerable: true, get: function () { return gauge_provider_1.createRegisteredGauge; } });
+var metrics_host_service_1 = require("./metrics/metrics-host.service");
+Object.defineProperty(exports, "APP_METER_NAME", { enumerable: true, get: function () { return metrics_host_service_1.APP_METER_NAME; } });
+Object.defineProperty(exports, "METRICS_HOST_OPTIONS", { enumerable: true, get: function () { return metrics_host_service_1.METRICS_HOST_OPTIONS; } });
+Object.defineProperty(exports, "MetricsHostService", { enumerable: true, get: function () { return metrics_host_service_1.MetricsHostService; } });
+var otel_metrics_module_1 = require("./metrics/otel-metrics.module");
+Object.defineProperty(exports, "OtelMetricsModule", { enumerable: true, get: function () { return otel_metrics_module_1.OtelMetricsModule; } });
+var request_span_attributes_1 = require("./spans/request-span-attributes");
+Object.defineProperty(exports, "ATTR_APP_REQUEST_BEARER", { enumerable: true, get: function () { return request_span_attributes_1.ATTR_APP_REQUEST_BEARER; } });
+Object.defineProperty(exports, "ATTR_APP_ROUTE_MATCHED", { enumerable: true, get: function () { return request_span_attributes_1.ATTR_APP_ROUTE_MATCHED; } });
+Object.defineProperty(exports, "ATTR_HTTP_ROUTE", { enumerable: true, get: function () { return request_span_attributes_1.ATTR_HTTP_ROUTE; } });
+Object.defineProperty(exports, "hasBearer", { enumerable: true, get: function () { return request_span_attributes_1.hasBearer; } });
+Object.defineProperty(exports, "registerRequestSpanAttributes", { enumerable: true, get: function () { return request_span_attributes_1.registerRequestSpanAttributes; } });
+Object.defineProperty(exports, "requestSpanAttributesHook", { enumerable: true, get: function () { return request_span_attributes_1.requestSpanAttributesHook; } });
+var trace_decorator_1 = require("./spans/trace.decorator");
+Object.defineProperty(exports, "Trace", { enumerable: true, get: function () { return trace_decorator_1.Trace; } });
+//# sourceMappingURL=index.js.map

package/dist/otel-core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/otel-core/index.ts"],"names":[],"mappings":";AAAA,uEAAuE;AACvE,4EAA4E;AAC5E,6EAA6E;AAC7E,+DAA+D;AAC/D,EAAE;AACF,8EAA8E;AAC9E,+DAA+D;;;;;;;;;;;;;;;;;AAE/D,8CAA4B;AAE5B,uEAWwC;AAVtC,wIAAA,gCAAgC,OAAA;AAChC,8HAAA,sBAAsB,OAAA;AACtB,+HAAA,uBAAuB,OAAA;AACvB,yHAAA,iBAAiB,OAAA;AACjB,uHAAA,eAAe,OAAA;AACf,0HAAA,kBAAkB,OAAA;AAMpB,2CAQ0B;AAPxB,qGAAA,WAAW,OAAA;AACX,6GAAA,mBAAmB,OAAA;AACnB,qGAAA,WAAW,OAAA;AACX,uGAAA,aAAa,OAAA;AACb,mGAAA,SAAS,OAAA;AACT,qGAAA,WAAW,OAAA;AACX,oGAAA,UAAU,OAAA;AAEZ,2DAKkC;AAJhC,uHAAA,qBAAqB,OAAA;AAKvB,uEAKwC;AAJtC,sHAAA,cAAc,OAAA;AACd,4HAAA,oBAAoB,OAAA;AACpB,0HAAA,kBAAkB,OAAA;AAGpB,qEAAsG;AAA7F,wHAAA,iBAAiB,OAAA;AAE1B,2EAOyC;AANvC,kIAAA,uBAAuB,OAAA;AACvB,iIAAA,sBAAsB,OAAA;AACtB,0HAAA,eAAe,OAAA;AACf,oHAAA,SAAS,OAAA;AACT,wIAAA,6BAA6B,OAAA;AAC7B,oIAAA,yBAAyB,OAAA;AAE3B,2DAAmE;AAA1D,wGAAA,KAAK,OAAA"}

package/dist/otel-core/metrics/gauge-provider.d.ts

@@ -0,0 +1,44 @@
+import type { Meter, ObservableGauge } from '@opentelemetry/api';
+import { type AppMetricKeys } from './metric-name.registry';
+/**
+ * A registered metric's code key: one an app typed by augmenting
+ * `AppMetricKeys`, or any string (checked against the registry at run time).
+ *
+ * @stability experimental
+ */
+export type AppMetricKeyLike = (keyof AppMetricKeys & string) | (string & {});
+/**
+ * What a gauge provider needs to follow the host's conventions.
+ *
+ * @stability stable
+ */
+export interface AppGaugeContext {
+    /** The `app` meter. */
+    meter: Meter;
+    /** The clock, in epoch milliseconds (a test seam). */
+    now: () => number;
+    /** Whether the runtime export gate is open; a callback queries nothing while it is closed. */
+    gateOpen: () => boolean;
+}
+/**
+ * A gauge provider: creates its gauges and their callback from the context.
+ * Called once, and only when gauges are on for this process.
+ *
+ * @stability experimental
+ */
+export type GaugeProvider = (context: AppGaugeContext) => void;
+/**
+ * Creates the observable gauge DECLARED under `key` in the app-metric
+ * registry, with its registered name, unit and description. For gauge
+ * providers: the callback is theirs, the descriptor is the registry's.
+ *
+ * @param meter - The meter from {@link AppGaugeContext}.
+ * @param key - The gauge's registry key.
+ * @returns The created gauge.
+ * @throws RegistryError `UNKNOWN_ID` when no metric is declared under `key`;
+ *   `Error` when the declared metric is not a gauge.
+ *
+ * @stability stable
+ */
+export declare function createRegisteredGauge(meter: Meter, key: AppMetricKeyLike): ObservableGauge;
+//# sourceMappingURL=gauge-provider.d.ts.map

package/dist/otel-core/metrics/gauge-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gauge-provider.d.ts","sourceRoot":"","sources":["../../../src/otel-core/metrics/gauge-provider.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,sDAAsD;IACtD,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,gBAAgB,GAAG,eAAe,CAI1F"}

package/dist/otel-core/metrics/gauge-provider.js

@@ -0,0 +1,37 @@
+"use strict";
+// =============================================================================
+// The gauge-provider seam (issue #606; generalised by issue #700)
+// =============================================================================
+//
+// Observable gauges are different from counters and histograms: their
+// callbacks QUERY something (a table, a fleet), so they belong to the module
+// that owns that something, not to the metrics host. The host hands such a
+// provider its meter, clock and export gate (`AppGaugeContext`), and only
+// when gauges are on for this process; the provider creates its gauges from
+// their registry declarations (`createRegisteredGauge`) and returns early
+// from its callback while the gate is closed, so a deployment with telemetry
+// off never pays for a single query.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRegisteredGauge = createRegisteredGauge;
+const metric_name_registry_1 = require("./metric-name.registry");
+/**
+ * Creates the observable gauge DECLARED under `key` in the app-metric
+ * registry, with its registered name, unit and description. For gauge
+ * providers: the callback is theirs, the descriptor is the registry's.
+ *
+ * @param meter - The meter from {@link AppGaugeContext}.
+ * @param key - The gauge's registry key.
+ * @returns The created gauge.
+ * @throws RegistryError `UNKNOWN_ID` when no metric is declared under `key`;
+ *   `Error` when the declared metric is not a gauge.
+ *
+ * @stability stable
+ */
+function createRegisteredGauge(meter, key) {
+    const def = metric_name_registry_1.appMetricRegistry.require(key);
+    if (def.kind !== 'gauge')
+        throw new Error(`App metric "${key}" is a ${def.kind}, not a gauge.`);
+    return meter.createObservableGauge(def.name, { description: def.description, unit: def.unit });
+}
+//# sourceMappingURL=gauge-provider.js.map

package/dist/otel-core/metrics/gauge-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gauge-provider.js","sourceRoot":"","sources":["../../../src/otel-core/metrics/gauge-provider.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,kEAAkE;AAClE,gFAAgF;AAChF,EAAE;AACF,sEAAsE;AACtE,6EAA6E;AAC7E,2EAA2E;AAC3E,0EAA0E;AAC1E,4EAA4E;AAC5E,0EAA0E;AAC1E,6EAA6E;AAC7E,qCAAqC;AACrC,gFAAgF;;AAiDhF,sDAIC;AAjDD,iEAA+E;AAgC/E;;;;;;;;;;;;GAYG;AACH,SAAgB,qBAAqB,CAAC,KAAY,EAAE,GAAqB;IACvE,MAAM,GAAG,GAAG,wCAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,UAAU,GAAG,CAAC,IAAI,gBAAgB,CAAC,CAAC;IAChG,OAAO,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AACjG,CAAC"}

package/dist/otel-core/metrics/labels.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Per attribute key, how many distinct free-form values are admitted before
+ * `other`, per process.
+ *
+ * @stability stable
+ */
+export declare const MAX_DISTINCT_VALUES = 100;
+/**
+ * The label a value outside its bound (shape, budget or enum) is exported as.
+ *
+ * @stability stable
+ */
+export declare const OTHER_LABEL = "other";
+/**
+ * The label an empty or missing value is exported as.
+ *
+ * @stability stable
+ */
+export declare const UNKNOWN_LABEL = "unknown";
+/**
+ * The SHAPE half of `MetricsHostService.boundLabel`, with no distinct-value
+ * budget: `unknown` when empty, `other` when the value is not
+ * identifier-shaped (at most 64 characters of `[A-Za-z0-9_.:/@+-]`, never
+ * address-shaped), else the trimmed value. For a label that is functionally
+ * dependent on another, already-bounded one (a node's name beside its capped
+ * `node_id`), where a per-process budget would only fold real values into
+ * `other` without bounding anything.
+ *
+ * @param value - Any value; non-strings are `unknown`.
+ * @returns The trimmed value, `other` or `unknown`.
+ *
+ * @stability stable
+ */
+export declare function shapeLabel(value: unknown): string;
+/**
+ * An enumerated value, or `other`.
+ *
+ * @param value - The value to check.
+ * @param allowed - The values the attribute admits.
+ * @returns `value` when it is one of `allowed`, else `other`.
+ *
+ * @stability stable
+ */
+export declare function enumLabel(value: unknown, allowed: ReadonlySet<string>): string;
+/**
+ * A non-negative finite number, or `null`: what a counter, histogram or
+ * duration accepts.
+ *
+ * @param value - The value to check.
+ * @returns `value`, or `null` when it is not a non-negative finite number.
+ *
+ * @stability stable
+ */
+export declare function nonNegative(value: unknown): number | null;
+/**
+ * Per-key distinct-value budgets: the stateful half of label bounding.
+ *
+ * @stability experimental
+ */
+export declare class LabelBudget {
+    private readonly maxDistinct;
+    /** Distinct free-form values admitted so far, per attribute key. */
+    private readonly seen;
+    /**
+     * @param maxDistinct - Distinct values admitted per key before `other`.
+     */
+    constructor(maxDistinct?: number);
+    /**
+     * A free-form string as a low-cardinality label: `unknown` when empty,
+     * `other` when it does not look like an identifier, is too long, or would
+     * be the `maxDistinct + 1`-th distinct value for `key`.
+     *
+     * @param key - The budget to charge (usually the attribute key).
+     * @param value - The raw value.
+     * @returns The bounded label.
+     */
+    bound(key: string, value: unknown): string;
+}
+//# sourceMappingURL=labels.d.ts.map

package/dist/otel-core/metrics/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../src/otel-core/metrics/labels.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAQvC;;;;GAIG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAE9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEzD;AAED;;;;GAIG;AACH,qBAAa,WAAW;IAOV,OAAO,CAAC,QAAQ,CAAC,WAAW;IANxC,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IAEvD;;OAEG;gBAC0B,WAAW,GAAE,MAA4B;IAEtE;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM;CAc3C"}

package/dist/otel-core/metrics/labels.js

@@ -0,0 +1,135 @@
+"use strict";
+// =============================================================================
+// Label bounding (issue #600; packaged by issue #700)
+// =============================================================================
+//
+// Attributes become GreptimeDB columns and series, so every label is bounded:
+// job type, status/outcome, executor, provider, model, operation, channel and
+// event key, NEVER a user id, an email, a URL or an error message. A
+// free-form string must look like an identifier (at most 64 characters of
+// `[A-Za-z0-9_.:/@+-]`, never address-shaped), and each attribute key admits
+// at most `MAX_DISTINCT_VALUES` distinct values per process; anything else
+// becomes `other`. Enumerated attributes (outcomes) are checked against their
+// allowed set and fall back to `other` too.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LabelBudget = exports.UNKNOWN_LABEL = exports.OTHER_LABEL = exports.MAX_DISTINCT_VALUES = void 0;
+exports.shapeLabel = shapeLabel;
+exports.enumLabel = enumLabel;
+exports.nonNegative = nonNegative;
+/**
+ * Per attribute key, how many distinct free-form values are admitted before
+ * `other`, per process.
+ *
+ * @stability stable
+ */
+exports.MAX_DISTINCT_VALUES = 100;
+/** The longest free-form label kept as is. */
+const MAX_LABEL_LENGTH = 64;
+const LABEL_PATTERN = /^[A-Za-z0-9_.:/@+-]+$/;
+/** `@` is allowed for versioned model ids (`model@20240620`), never for an address. */
+const EMAIL_LIKE = /@[^@]*\./;
+/**
+ * The label a value outside its bound (shape, budget or enum) is exported as.
+ *
+ * @stability stable
+ */
+exports.OTHER_LABEL = 'other';
+/**
+ * The label an empty or missing value is exported as.
+ *
+ * @stability stable
+ */
+exports.UNKNOWN_LABEL = 'unknown';
+/**
+ * The SHAPE half of `MetricsHostService.boundLabel`, with no distinct-value
+ * budget: `unknown` when empty, `other` when the value is not
+ * identifier-shaped (at most 64 characters of `[A-Za-z0-9_.:/@+-]`, never
+ * address-shaped), else the trimmed value. For a label that is functionally
+ * dependent on another, already-bounded one (a node's name beside its capped
+ * `node_id`), where a per-process budget would only fold real values into
+ * `other` without bounding anything.
+ *
+ * @param value - Any value; non-strings are `unknown`.
+ * @returns The trimmed value, `other` or `unknown`.
+ *
+ * @stability stable
+ */
+function shapeLabel(value) {
+    if (typeof value !== 'string')
+        return exports.UNKNOWN_LABEL;
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return exports.UNKNOWN_LABEL;
+    if (trimmed.length > MAX_LABEL_LENGTH || !LABEL_PATTERN.test(trimmed) || EMAIL_LIKE.test(trimmed)) {
+        return exports.OTHER_LABEL;
+    }
+    return trimmed;
+}
+/**
+ * An enumerated value, or `other`.
+ *
+ * @param value - The value to check.
+ * @param allowed - The values the attribute admits.
+ * @returns `value` when it is one of `allowed`, else `other`.
+ *
+ * @stability stable
+ */
+function enumLabel(value, allowed) {
+    return typeof value === 'string' && allowed.has(value) ? value : exports.OTHER_LABEL;
+}
+/**
+ * A non-negative finite number, or `null`: what a counter, histogram or
+ * duration accepts.
+ *
+ * @param value - The value to check.
+ * @returns `value`, or `null` when it is not a non-negative finite number.
+ *
+ * @stability stable
+ */
+function nonNegative(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : null;
+}
+/**
+ * Per-key distinct-value budgets: the stateful half of label bounding.
+ *
+ * @stability experimental
+ */
+class LabelBudget {
+    maxDistinct;
+    /** Distinct free-form values admitted so far, per attribute key. */
+    seen = new Map();
+    /**
+     * @param maxDistinct - Distinct values admitted per key before `other`.
+     */
+    constructor(maxDistinct = exports.MAX_DISTINCT_VALUES) {
+        this.maxDistinct = maxDistinct;
+    }
+    /**
+     * A free-form string as a low-cardinality label: `unknown` when empty,
+     * `other` when it does not look like an identifier, is too long, or would
+     * be the `maxDistinct + 1`-th distinct value for `key`.
+     *
+     * @param key - The budget to charge (usually the attribute key).
+     * @param value - The raw value.
+     * @returns The bounded label.
+     */
+    bound(key, value) {
+        const trimmed = shapeLabel(value);
+        if (trimmed === exports.UNKNOWN_LABEL || trimmed === exports.OTHER_LABEL)
+            return trimmed;
+        let seen = this.seen.get(key);
+        if (!seen) {
+            seen = new Set();
+            this.seen.set(key, seen);
+        }
+        if (seen.has(trimmed))
+            return trimmed;
+        if (seen.size >= this.maxDistinct)
+            return exports.OTHER_LABEL;
+        seen.add(trimmed);
+        return trimmed;
+    }
+}
+exports.LabelBudget = LabelBudget;
+//# sourceMappingURL=labels.js.map

package/dist/otel-core/metrics/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../src/otel-core/metrics/labels.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,sDAAsD;AACtD,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,qEAAqE;AACrE,0EAA0E;AAC1E,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,4CAA4C;AAC5C,gFAAgF;;;AA4ChF,gCAQC;AAWD,8BAEC;AAWD,kCAEC;AA5ED;;;;;GAKG;AACU,QAAA,mBAAmB,GAAG,GAAG,CAAC;AAEvC,8CAA8C;AAC9C,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAC9C,uFAAuF;AACvF,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B;;;;GAIG;AACU,QAAA,WAAW,GAAG,OAAO,CAAC;AAEnC;;;;GAIG;AACU,QAAA,aAAa,GAAG,SAAS,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,SAAgB,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,qBAAa,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,qBAAa,CAAC;IAC/C,IAAI,OAAO,CAAC,MAAM,GAAG,gBAAgB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClG,OAAO,mBAAW,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAC,KAAc,EAAE,OAA4B;IACpE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAW,CAAC;AAC/E,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1F,CAAC;AAED;;;;GAIG;AACH,MAAa,WAAW;IAOO;IAN7B,oEAAoE;IACnD,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEvD;;OAEG;IACH,YAA6B,cAAsB,2BAAmB;QAAzC,gBAAW,GAAX,WAAW,CAA8B;IAAG,CAAC;IAE1E;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAW,EAAE,KAAc;QAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,OAAO,KAAK,qBAAa,IAAI,OAAO,KAAK,mBAAW;YAAE,OAAO,OAAO,CAAC;QAEzE,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QACtC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,mBAAW,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAhCD,kCAgCC"}

package/dist/otel-core/metrics/metric-name.registry.d.ts

@@ -0,0 +1,130 @@
+import { type Registry } from '../../core/index';
+/**
+ * The OTel instrument kind. Gauges are declared for their name, unit and
+ * description; their callbacks stay code.
+ *
+ * @stability stable
+ */
+export type AppMetricKind = 'counter' | 'histogram' | 'gauge';
+/**
+ * How one attribute is bounded before it becomes a label (a GreptimeDB column).
+ *
+ * - `enum`: the value must be one of `values`, else it is exported as `other`.
+ * - `free`: an identifier-shaped string through `MetricsHostService.boundLabel`
+ *   (at most 64 characters of `[A-Za-z0-9_.:/@+-]`, never address-shaped, and
+ *   at most `MAX_DISTINCT_VALUES` distinct values per attribute key per
+ *   process); anything else becomes `other` (or `unknown` when empty).
+ *
+ * Neither admits a user id, an e-mail, a URL or an error message as a label:
+ * declare an attribute only for a low-cardinality dimension (a type, a status,
+ * an outcome, a provider).
+ *
+ * @stability stable
+ */
+export type AppMetricAttribute = {
+    /** One of `values`, else `other`. */
+    kind: 'enum';
+    /** The allowed values, non-empty strings. */
+    values: readonly string[];
+} | {
+    /** An identifier-shaped string, bounded per key. */
+    kind: 'free';
+};
+/**
+ * One declared `app.*` metric.
+ *
+ * @stability stable
+ */
+export interface AppMetricDef {
+    /** Stable code key, e.g. `jobsEnqueued`: what `add`/`record` and `APP_METRIC_NAMES` use. lowerCamelCase. */
+    key: string;
+    /** OTLP name, e.g. `app.jobs.enqueued`: `app.` then dot-separated snake_case segments. Permanent. */
+    name: string;
+    /** The instrument kind. */
+    kind: AppMetricKind;
+    /** OTel unit: `s`, `By`, `{job}`, `1` … (it picks the GreptimeDB table suffix, docs §11.3). */
+    unit: string;
+    /** One sentence, exported as the instrument's description. */
+    description: string;
+    /** Histogram bucket boundaries, ascending, in `unit`. Histograms only. */
+    buckets?: readonly number[];
+    /** The attribute keys the metric may carry (snake_case, no dots); any other key is dropped. */
+    attributes?: Readonly<Record<string, AppMetricAttribute>>;
+}
+/**
+ * The augmentable set of app metric keys, so `add`/`record` and
+ * `createRegisteredGauge` type-check an app's own keys. An app widens it next
+ * to its declarations:
+ *
+ * ```ts
+ * declare module '@marinoscar/platform-api/otel-core' {
+ *   interface AppMetricKeys { coachNudgesSent: true }
+ * }
+ * ```
+ *
+ * @stability experimental
+ */
+export interface AppMetricKeys {
+}
+/**
+ * `app.` then one or more dot-separated snake_case segments.
+ *
+ * @stability stable
+ */
+export declare const APP_METRIC_NAME_PATTERN: RegExp;
+/**
+ * Attribute keys become columns: snake_case, no dots (a dotted column needs
+ * quoting in every statement).
+ *
+ * @stability stable
+ */
+export declare const APP_METRIC_ATTRIBUTE_KEY_PATTERN: RegExp;
+/**
+ * Code keys are lowerCamelCase.
+ *
+ * @stability stable
+ */
+export declare const APP_METRIC_KEY_PATTERN: RegExp;
+/**
+ * Every rule a declaration must satisfy, against the declarations already
+ * known. Throws a plain `Error`. A known declaration with the SAME key is
+ * ignored, so re-registering a key reports the registry's `DUPLICATE_ID`.
+ *
+ * @param def - The declaration to check.
+ * @param known - The declarations already registered.
+ * @throws Error naming the metric and the broken rule.
+ *
+ * @stability stable
+ */
+export declare function assertAppMetric(def: AppMetricDef, known: readonly AppMetricDef[]): void;
+/**
+ * Every declared `app.*` metric, in registration order. Frozen once the Nest
+ * application has bootstrapped (`RegistryFreezeService`). Register through
+ * {@link registerAppMetrics}; read with `list()`, `require(key)`, `has(key)`.
+ *
+ * @extensionPoint registry
+ * @stability stable
+ */
+export declare const appMetricRegistry: Registry<AppMetricDef>;
+/**
+ * Registers `defs`, all or nothing, also refusing two declarations of one
+ * batch that share a NAME (the registry's `validate` hook alone does not see a
+ * batch's earlier entries). Call it at import time, from a manifest the
+ * metrics service imports.
+ *
+ * @param defs - The declarations, in order.
+ * @throws RegistryError `INVALID_ENTRY`, `INVALID_ID`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```ts
+ * registerAppMetrics([
+ *   { key: 'coachNudgesSent', name: 'app.coach.nudges.sent', kind: 'counter', unit: '{nudge}',
+ *     description: 'Coach nudges sent.', attributes: { channel: { kind: 'free' } } },
+ * ]);
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability stable
+ */
+export declare function registerAppMetrics(defs: readonly AppMetricDef[]): void;
+//# sourceMappingURL=metric-name.registry.d.ts.map

package/dist/otel-core/metrics/metric-name.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-name.registry.d.ts","sourceRoot":"","sources":["../../../src/otel-core/metrics/metric-name.registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA6BhF;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,GACD;IACE,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,4GAA4G;IAC5G,GAAG,EAAE,MAAM,CAAC;IACZ,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,+FAA+F;IAC/F,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;CAAG;AAEjC;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAA8B,CAAC;AACnE;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,QAAsB,CAAC;AACpE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAwB,CAAC;AAQ5D;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CA6CvF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,YAAY,CAOnD,CAAC;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAgBtE"}

package/dist/otel-core/metrics/metric-name.registry.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appMetricRegistry = exports.APP_METRIC_KEY_PATTERN = exports.APP_METRIC_ATTRIBUTE_KEY_PATTERN = exports.APP_METRIC_NAME_PATTERN = void 0;
+exports.assertAppMetric = assertAppMetric;
+exports.registerAppMetrics = registerAppMetrics;
+const index_1 = require("../../core/index");
+/**
+ * `app.` then one or more dot-separated snake_case segments.
+ *
+ * @stability stable
+ */
+exports.APP_METRIC_NAME_PATTERN = /^app(\.[a-z][a-z0-9_]*)+$/;
+/**
+ * Attribute keys become columns: snake_case, no dots (a dotted column needs
+ * quoting in every statement).
+ *
+ * @stability stable
+ */
+exports.APP_METRIC_ATTRIBUTE_KEY_PATTERN = /^[a-z][a-z0-9_]*$/;
+/**
+ * Code keys are lowerCamelCase.
+ *
+ * @stability stable
+ */
+exports.APP_METRIC_KEY_PATTERN = /^[a-z][A-Za-z0-9]*$/;
+const KINDS = new Set(['counter', 'histogram', 'gauge']);
+function assertText(value, where) {
+    if (typeof value !== 'string' || value.trim() === '')
+        throw new Error(`${where} must be a non-empty string.`);
+}
+/**
+ * Every rule a declaration must satisfy, against the declarations already
+ * known. Throws a plain `Error`. A known declaration with the SAME key is
+ * ignored, so re-registering a key reports the registry's `DUPLICATE_ID`.
+ *
+ * @param def - The declaration to check.
+ * @param known - The declarations already registered.
+ * @throws Error naming the metric and the broken rule.
+ *
+ * @stability stable
+ */
+function assertAppMetric(def, known) {
+    const where = `App metric "${def.key}"`;
+    if (typeof def.name !== 'string' || !exports.APP_METRIC_NAME_PATTERN.test(def.name)) {
+        throw new Error(`${where} name ${JSON.stringify(def.name)} must start with "app." and match ${exports.APP_METRIC_NAME_PATTERN}.`);
+    }
+    const clash = known.find((other) => other.key !== def.key && other.name === def.name);
+    if (clash)
+        throw new Error(`${where} name "${def.name}" is already declared by "${clash.key}".`);
+    if (!KINDS.has(def.kind))
+        throw new Error(`${where} kind ${JSON.stringify(def.kind)} must be counter, histogram or gauge.`);
+    assertText(def.unit, `${where} unit`);
+    assertText(def.description, `${where} description`);
+    if (def.buckets !== undefined) {
+        if (def.kind !== 'histogram')
+            throw new Error(`${where} declares buckets, which only a histogram takes.`);
+        if (!Array.isArray(def.buckets) || def.buckets.length === 0) {
+            throw new Error(`${where} buckets must be a non-empty array.`);
+        }
+        def.buckets.forEach((bound, index) => {
+            if (typeof bound !== 'number' || !Number.isFinite(bound)) {
+                throw new Error(`${where} bucket ${index} is not a finite number.`);
+            }
+            if (index > 0 && !(bound > def.buckets[index - 1])) {
+                throw new Error(`${where} buckets must be strictly ascending (bucket ${index}: ${bound}).`);
+            }
+        });
+    }
+    for (const [key, attribute] of Object.entries(def.attributes ?? {})) {
+        if (!exports.APP_METRIC_ATTRIBUTE_KEY_PATTERN.test(key)) {
+            throw new Error(`${where} attribute key "${key}" must be snake_case without dots (${exports.APP_METRIC_ATTRIBUTE_KEY_PATTERN}).`);
+        }
+        if (attribute?.kind === 'enum') {
+            if (!Array.isArray(attribute.values) || attribute.values.length === 0) {
+                throw new Error(`${where} attribute "${key}" is an enum without values.`);
+            }
+            if (attribute.values.some((v) => typeof v !== 'string' || v === '')) {
+                throw new Error(`${where} attribute "${key}" enum values must be non-empty strings.`);
+            }
+        }
+        else if (attribute?.kind !== 'free') {
+            throw new Error(`${where} attribute "${key}" kind must be "enum" or "free".`);
+        }
+    }
+}
+/**
+ * Every declared `app.*` metric, in registration order. Frozen once the Nest
+ * application has bootstrapped (`RegistryFreezeService`). Register through
+ * {@link registerAppMetrics}; read with `list()`, `require(key)`, `has(key)`.
+ *
+ * @extensionPoint registry
+ * @stability stable
+ */
+exports.appMetricRegistry = (0, index_1.defineRegistry)({
+    name: 'app-metrics',
+    idOf: (def) => def.key,
+    idPattern: exports.APP_METRIC_KEY_PATTERN,
+    validate: (def, registry) => assertAppMetric(def, registry.list()),
+    describeDuplicate: (_existing, incoming) => `Duplicate app metric key "${incoming.key}": a metric key is declared once (platform metrics first, then the app's).`,
+});
+/**
+ * Registers `defs`, all or nothing, also refusing two declarations of one
+ * batch that share a NAME (the registry's `validate` hook alone does not see a
+ * batch's earlier entries). Call it at import time, from a manifest the
+ * metrics service imports.
+ *
+ * @param defs - The declarations, in order.
+ * @throws RegistryError `INVALID_ENTRY`, `INVALID_ID`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```ts
+ * registerAppMetrics([
+ *   { key: 'coachNudgesSent', name: 'app.coach.nudges.sent', kind: 'counter', unit: '{nudge}',
+ *     description: 'Coach nudges sent.', attributes: { channel: { kind: 'free' } } },
+ * ]);
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability stable
+ */
+function registerAppMetrics(defs) {
+    const names = new Map();
+    for (const def of defs) {
+        const earlier = typeof def?.name === 'string' ? names.get(def.name) : undefined;
+        if (earlier !== undefined && earlier !== def.key) {
+            throw new index_1.RegistryError('INVALID_ENTRY', exports.appMetricRegistry.name, `Invalid entry "${def.key}" in registry "${exports.appMetricRegistry.name}": App metric "${def.key}" name "${def.name}" ` +
+                `is already declared by "${earlier}".`, { id: def.key });
+        }
+        if (typeof def?.name === 'string')
+            names.set(def.name, def.key);
+    }
+    exports.appMetricRegistry.registerAll(defs);
+}
+//# sourceMappingURL=metric-name.registry.js.map

package/dist/otel-core/metrics/metric-name.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-name.registry.js","sourceRoot":"","sources":["../../../src/otel-core/metrics/metric-name.registry.ts"],"names":[],"mappings":";;;AA0IA,0CA6CC;AAuCD,gDAgBC;AA9OD,4CAAgF;AAqGhF;;;;GAIG;AACU,QAAA,uBAAuB,GAAG,2BAA2B,CAAC;AACnE;;;;;GAKG;AACU,QAAA,gCAAgC,GAAG,mBAAmB,CAAC;AACpE;;;;GAIG;AACU,QAAA,sBAAsB,GAAG,qBAAqB,CAAC;AAE5D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjE,SAAS,UAAU,CAAC,KAAc,EAAE,KAAa;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;AAChH,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,eAAe,CAAC,GAAiB,EAAE,KAA8B;IAC/E,MAAM,KAAK,GAAG,eAAe,GAAG,CAAC,GAAG,GAAG,CAAC;IAExC,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,+BAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,qCAAqC,+BAAuB,GAAG,CACzG,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACtF,IAAI,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU,GAAG,CAAC,IAAI,6BAA6B,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAEjG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAC5H,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IACtC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,KAAK,cAAc,CAAC,CAAC;IAEpD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,kDAAkD,CAAC,CAAC;QAC1G,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qCAAqC,CAAC,CAAC;QACjE,CAAC;QACD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW,KAAK,0BAA0B,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,OAAQ,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+CAA+C,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC,wCAAgC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,GAAG,sCAAsC,wCAAgC,IAAI,CAAC,CAAC;QAC5H,CAAC;QACD,IAAI,SAAS,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,eAAe,GAAG,8BAA8B,CAAC,CAAC;YAC5E,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;gBACpE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,eAAe,GAAG,0CAA0C,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;aAAM,IAAI,SAAS,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,eAAe,GAAG,kCAAkC,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACU,QAAA,iBAAiB,GAA2B,IAAA,sBAAc,EAAe;IACpF,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG;IACtB,SAAS,EAAE,8BAAsB;IACjC,QAAQ,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IAClE,iBAAiB,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,CACzC,6BAA6B,QAAQ,CAAC,GAAG,4EAA4E;CACxH,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,kBAAkB,CAAC,IAA6B;IAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,GAAG,CAAC,GAAG,EAAE,CAAC;YACjD,MAAM,IAAI,qBAAa,CACrB,eAAe,EACf,yBAAiB,CAAC,IAAI,EACtB,kBAAkB,GAAG,CAAC,GAAG,kBAAkB,yBAAiB,CAAC,IAAI,kBAAkB,GAAG,CAAC,GAAG,WAAW,GAAG,CAAC,IAAI,IAAI;gBAC/G,2BAA2B,OAAO,IAAI,EACxC,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,CAChB,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAClE,CAAC;IACD,yBAAiB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}