@opengeni/observability 0.2.1 → 0.3.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Cloudgeni-ai
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.d.ts

@@ -3,6 +3,7 @@ type Attributes = Record<string, AttributeValue>;
 type ObservabilitySettings = {
     serviceName: string;
     environment: string;
+    deploymentRevision?: string | undefined;
     observabilityStructuredLogs: boolean;
     observabilityMetricsEnabled: boolean;
     observabilityOtlpEndpoint?: string | undefined;
@@ -21,15 +22,21 @@ type Span = {
         error?: unknown;
     }) => void;
 };
+type MetricLabels = Record<string, AttributeValue>;
 declare function createObservability(settings: ObservabilitySettings, options: ObservabilityOptions): Observability;
 declare class Observability {
     private readonly settings;
     private readonly options;
-    private readonly metrics;
+    private readonly registry;
+    private readonly counters;
+    private readonly gauges;
+    private readonly histograms;
+    private readonly registrations;
     private readonly now;
     private readonly exporter;
     private readonly resourceAttributes;
     constructor(settings: ObservabilitySettings, options: ObservabilityOptions);
+    debug(message: string, attributes?: Attributes): void;
     info(message: string, attributes?: Attributes): void;
     warn(message: string, attributes?: Attributes): void;
     error(message: string, attributes?: Attributes): void;
@@ -46,7 +53,37 @@ declare class Observability {
         status: string;
         durationSeconds: number;
     }): void;
-    prometheusMetrics(): string;
+    incrementCounter(input: {
+        name: string;
+        help?: string;
+        labels?: MetricLabels;
+        amount?: number;
+    }): void;
+    setGauge(input: {
+        name: string;
+        help?: string;
+        labels?: MetricLabels;
+        value: number;
+    }): void;
+    incrementGauge(input: {
+        name: string;
+        help?: string;
+        labels?: MetricLabels;
+        amount?: number;
+    }): void;
+    observeHistogram(input: {
+        name: string;
+        help?: string;
+        labels?: MetricLabels;
+        value: number;
+        buckets?: number[];
+    }): void;
+    prometheusMetrics(): Promise<string>;
+    private counter;
+    private gauge;
+    private histogram;
+    private register;
+    private assertRegistration;
     private exportSpan;
 }
 type StartupDependencyRetryEvent = {
@@ -59,4 +96,4 @@ type StartupDependencyRetryEvent = {
 declare function logStartupDependencyRetry(observability: Observability, event: StartupDependencyRetryEvent): void;
 declare function parseHeaders(value: string): Record<string, string>;
 
-export { type AttributeValue, type Attributes, Observability, type ObservabilityOptions, type ObservabilitySettings, type Span, type StartupDependencyRetryEvent, createObservability, logStartupDependencyRetry, parseHeaders };
+export { type AttributeValue, type Attributes, type MetricLabels, Observability, type ObservabilityOptions, type ObservabilitySettings, type Span, type StartupDependencyRetryEvent, createObservability, logStartupDependencyRetry, parseHeaders };

package/dist/index.js

@@ -1,5 +1,13 @@
 // src/index.ts
-var histogramBuckets = [5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+import {
+  collectDefaultMetrics,
+  Counter,
+  Gauge,
+  Histogram,
+  Registry
+} from "prom-client";
+var httpHistogramBuckets = [5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+var durationHistogramBuckets = [0.01, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10, 30, 60, 120, 300, 900, 1800, 3600];
 function createObservability(settings, options) {
   return new Observability(settings, options);
 }
@@ -14,13 +22,37 @@ var Observability = class {
       "deployment.environment": settings.environment,
       "opengeni.component": options.component
     };
+    this.registry.setDefaultLabels({
+      service: settings.serviceName,
+      environment: settings.environment,
+      component: options.component
+    });
+    if (settings.observabilityMetricsEnabled) {
+      collectDefaultMetrics({ register: this.registry, prefix: "opengeni_" });
+      this.setGauge({
+        name: "opengeni_build_info",
+        help: "OpenGeni build information.",
+        labels: {
+          version: buildVersion(),
+          revision: settings.deploymentRevision ?? "dev"
+        },
+        value: 1
+      });
+    }
   }
   settings;
   options;
-  metrics = new MetricsRegistry();
+  registry = new Registry();
+  counters = /* @__PURE__ */ new Map();
+  gauges = /* @__PURE__ */ new Map();
+  histograms = /* @__PURE__ */ new Map();
+  registrations = /* @__PURE__ */ new Map();
   now;
   exporter;
   resourceAttributes;
+  debug(message, attributes = {}) {
+    this.log("debug", message, attributes);
+  }
   info(message, attributes = {}) {
     this.log("info", message, attributes);
   }
@@ -91,43 +123,137 @@ var Observability = class {
     };
   }
   recordHttpRequest(input) {
+    this.incrementCounter({
+      name: "opengeni_http_requests_total",
+      help: "Total HTTP requests handled by OpenGeni.",
+      labels: {
+        method: input.method,
+        route: input.route,
+        status: String(input.status),
+        component: this.options.component
+      }
+    });
+    this.observeHistogram({
+      name: "opengeni_http_request_duration_seconds",
+      help: "HTTP request duration in seconds.",
+      buckets: httpHistogramBuckets,
+      value: input.durationSeconds,
+      labels: {
+        method: input.method,
+        route: input.route,
+        component: this.options.component
+      }
+    });
+  }
+  recordWorkerActivity(input) {
+    this.incrementCounter({
+      name: "opengeni_worker_activity_runs_total",
+      help: "Total worker activity executions.",
+      labels: {
+        activity: input.activity,
+        status: input.status,
+        component: this.options.component
+      }
+    });
+    this.observeHistogram({
+      name: "opengeni_worker_activity_duration_seconds",
+      help: "Worker activity duration in seconds.",
+      buckets: durationHistogramBuckets,
+      value: input.durationSeconds,
+      labels: {
+        activity: input.activity,
+        component: this.options.component
+      }
+    });
+  }
+  incrementCounter(input) {
     if (!this.settings.observabilityMetricsEnabled) {
       return;
     }
-    const labels = {
-      method: input.method,
-      route: input.route,
-      status: String(input.status),
-      component: this.options.component
-    };
-    this.metrics.increment("opengeni_http_requests_total", labels);
-    this.metrics.observe("opengeni_http_request_duration_seconds", histogramBuckets, input.durationSeconds, {
-      method: input.method,
-      route: input.route,
-      component: this.options.component
-    });
+    const labels = normalizeLabels(input.labels);
+    const counter = this.counter(input.name, input.help ?? `${input.name} counter.`, Object.keys(labels));
+    counter.inc(labels, input.amount ?? 1);
   }
-  recordWorkerActivity(input) {
+  setGauge(input) {
     if (!this.settings.observabilityMetricsEnabled) {
       return;
     }
-    const labels = {
-      activity: input.activity,
-      status: input.status,
-      component: this.options.component
-    };
-    this.metrics.increment("opengeni_worker_activity_runs_total", labels);
-    this.metrics.observe("opengeni_worker_activity_duration_seconds", histogramBuckets, input.durationSeconds, {
-      activity: input.activity,
-      component: this.options.component
-    });
+    const labels = normalizeLabels(input.labels);
+    const gauge = this.gauge(input.name, input.help ?? `${input.name} gauge.`, Object.keys(labels));
+    gauge.set(labels, input.value);
   }
-  prometheusMetrics() {
-    return this.metrics.toPrometheus({
-      service: this.settings.serviceName,
-      environment: this.settings.environment,
-      component: this.options.component
-    });
+  incrementGauge(input) {
+    if (!this.settings.observabilityMetricsEnabled) {
+      return;
+    }
+    const labels = normalizeLabels(input.labels);
+    const gauge = this.gauge(input.name, input.help ?? `${input.name} gauge.`, Object.keys(labels));
+    gauge.inc(labels, input.amount ?? 1);
+  }
+  observeHistogram(input) {
+    if (!this.settings.observabilityMetricsEnabled) {
+      return;
+    }
+    const labels = normalizeLabels(input.labels);
+    const histogram = this.histogram(
+      input.name,
+      input.help ?? `${input.name} histogram.`,
+      Object.keys(labels),
+      input.buckets ?? durationHistogramBuckets
+    );
+    histogram.observe(labels, input.value);
+  }
+  async prometheusMetrics() {
+    if (!this.settings.observabilityMetricsEnabled) {
+      return "";
+    }
+    return await this.registry.metrics();
+  }
+  counter(name, help, labelNames) {
+    const existing = this.counters.get(name);
+    if (existing) {
+      this.assertRegistration(name, "counter", labelNames);
+      return existing;
+    }
+    this.register(name, "counter", labelNames);
+    const metric = new Counter({ name, help, labelNames, registers: [this.registry] });
+    this.counters.set(name, metric);
+    return metric;
+  }
+  gauge(name, help, labelNames) {
+    const existing = this.gauges.get(name);
+    if (existing) {
+      this.assertRegistration(name, "gauge", labelNames);
+      return existing;
+    }
+    this.register(name, "gauge", labelNames);
+    const metric = new Gauge({ name, help, labelNames, registers: [this.registry] });
+    this.gauges.set(name, metric);
+    return metric;
+  }
+  histogram(name, help, labelNames, buckets) {
+    const existing = this.histograms.get(name);
+    if (existing) {
+      this.assertRegistration(name, "histogram", labelNames);
+      return existing;
+    }
+    this.register(name, "histogram", labelNames);
+    const metric = new Histogram({ name, help, labelNames, buckets, registers: [this.registry] });
+    this.histograms.set(name, metric);
+    return metric;
+  }
+  register(name, kind, labelNames) {
+    const sorted = [...labelNames].sort();
+    this.registrations.set(name, { kind, labelNames: sorted });
+  }
+  assertRegistration(name, kind, labelNames) {
+    const registration = this.registrations.get(name);
+    const sorted = [...labelNames].sort();
+    if (!registration || registration.kind !== kind || registration.labelNames.length !== sorted.length || registration.labelNames.some((label, index) => label !== sorted[index])) {
+      throw new Error(
+        `Metric ${name} was already registered as ${registration?.kind ?? "unknown"} with labels [${registration?.labelNames.join(",") ?? ""}], not ${kind} [${sorted.join(",")}]`
+      );
+    }
   }
   exportSpan(span) {
     if (!this.settings.observabilityOtlpEndpoint) {
@@ -172,79 +298,13 @@ function logStartupDependencyRetry(observability, event) {
     error: message
   });
 }
-var MetricsRegistry = class {
-  counters = /* @__PURE__ */ new Map();
-  histograms = /* @__PURE__ */ new Map();
-  increment(name, labels, amount = 1) {
-    const key = metricKey(name, labels);
-    this.counters.set(key, (this.counters.get(key) ?? 0) + amount);
-  }
-  observe(name, buckets, value, labels) {
-    const key = metricKey(name, labels);
-    const histogram = this.histograms.get(key) ?? {
-      buckets,
-      counts: buckets.map(() => 0),
-      sum: 0,
-      count: 0,
-      labels
-    };
-    histogram.sum += value;
-    histogram.count += 1;
-    for (let index = 0; index < buckets.length; index += 1) {
-      if (value <= buckets[index]) {
-        histogram.counts[index] = (histogram.counts[index] ?? 0) + 1;
-      }
-    }
-    this.histograms.set(key, histogram);
-  }
-  toPrometheus(resourceLabels) {
-    const lines = [
-      "# HELP opengeni_http_requests_total Total HTTP requests handled by the OpenGeni API.",
-      "# TYPE opengeni_http_requests_total counter"
-    ];
-    for (const [key, value] of this.counters) {
-      const { name, labels } = parseMetricKey(key);
-      if (name.endsWith("_total")) {
-        lines.push(`${name}${formatLabels({ ...resourceLabels, ...labels })} ${value}`);
-      }
-    }
-    lines.push(
-      "# HELP opengeni_http_request_duration_seconds HTTP request duration in seconds.",
-      "# TYPE opengeni_http_request_duration_seconds histogram",
-      "# HELP opengeni_worker_activity_runs_total Total worker activity executions.",
-      "# TYPE opengeni_worker_activity_runs_total counter",
-      "# HELP opengeni_worker_activity_duration_seconds Worker activity duration in seconds.",
-      "# TYPE opengeni_worker_activity_duration_seconds histogram"
-    );
-    for (const [key, histogram] of this.histograms) {
-      const { name, labels } = parseMetricKey(key);
-      const baseLabels = { ...resourceLabels, ...labels };
-      for (let index = 0; index < histogram.buckets.length; index += 1) {
-        lines.push(`${name}_bucket${formatLabels({ ...baseLabels, le: String(histogram.buckets[index]) })} ${histogram.counts[index]}`);
-      }
-      lines.push(`${name}_bucket${formatLabels({ ...baseLabels, le: "+Inf" })} ${histogram.count}`);
-      lines.push(`${name}_sum${formatLabels(baseLabels)} ${histogram.sum}`);
-      lines.push(`${name}_count${formatLabels(baseLabels)} ${histogram.count}`);
-    }
-    return `${lines.join("\n")}
-`;
-  }
-};
-function metricKey(name, labels) {
-  return JSON.stringify({ name, labels: Object.fromEntries(Object.entries(labels).sort(([a], [b]) => a.localeCompare(b))) });
-}
-function parseMetricKey(key) {
-  return JSON.parse(key);
-}
-function formatLabels(labels) {
-  const entries = Object.entries(labels).filter(([, value]) => value.length > 0);
-  if (entries.length === 0) {
-    return "";
-  }
-  return `{${entries.map(([key, value]) => `${key}="${escapeMetricLabel(value)}"`).join(",")}}`;
+function normalizeLabels(labels = {}) {
+  return Object.fromEntries(
+    Object.entries(labels).filter(([, value]) => value !== void 0 && value !== null).map(([key, value]) => [key, String(value)]).sort((left, right) => left[0].localeCompare(right[0]))
+  );
 }
-function escapeMetricLabel(value) {
-  return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n");
+function buildVersion() {
+  return process.env.OPENGENI_VERSION ?? process.env.npm_package_version ?? "dev";
 }
 function cleanAttributes(attributes) {
   return Object.fromEntries(Object.entries(attributes).filter(([, value]) => value !== void 0));

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type AttributeValue = string | number | boolean | null | undefined;\nexport type Attributes = Record<string, AttributeValue>;\n\nexport type ObservabilitySettings = {\n  serviceName: string;\n  environment: string;\n  observabilityStructuredLogs: boolean;\n  observabilityMetricsEnabled: boolean;\n  observabilityOtlpEndpoint?: string | undefined;\n  observabilityOtlpHeaders: string;\n};\n\nexport type ObservabilityOptions = {\n  component: string;\n  now?: () => number;\n  exporter?: (url: string, body: unknown, headers: Record<string, string>) => Promise<void>;\n};\n\nexport type Span = {\n  traceId: string;\n  spanId: string;\n  end: (input?: { attributes?: Attributes; error?: unknown }) => void;\n};\n\nconst histogramBuckets = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];\n\nexport function createObservability(settings: ObservabilitySettings, options: ObservabilityOptions): Observability {\n  return new Observability(settings, options);\n}\n\nexport class Observability {\n  private readonly metrics = new MetricsRegistry();\n  private readonly now: () => number;\n  private readonly exporter: (url: string, body: unknown, headers: Record<string, string>) => Promise<void>;\n  private readonly resourceAttributes: Attributes;\n\n  constructor(private readonly settings: ObservabilitySettings, private readonly options: ObservabilityOptions) {\n    this.now = options.now ?? Date.now;\n    this.exporter = options.exporter ?? defaultExporter;\n    this.resourceAttributes = {\n      \"service.name\": settings.serviceName,\n      \"deployment.environment\": settings.environment,\n      \"opengeni.component\": options.component,\n    };\n  }\n\n  info(message: string, attributes: Attributes = {}): void {\n    this.log(\"info\", message, attributes);\n  }\n\n  warn(message: string, attributes: Attributes = {}): void {\n    this.log(\"warn\", message, attributes);\n  }\n\n  error(message: string, attributes: Attributes = {}): void {\n    this.log(\"error\", message, attributes);\n  }\n\n  log(level: \"debug\" | \"info\" | \"warn\" | \"error\", message: string, attributes: Attributes = {}): void {\n    if (!this.settings.observabilityStructuredLogs) {\n      const line = attributes.error ? `${message}: ${String(attributes.error)}` : message;\n      if (level === \"warn\") {\n        console.warn(line);\n      } else if (level === \"error\") {\n        console.error(line);\n      } else {\n        console.log(line);\n      }\n      return;\n    }\n    const record = {\n      timestamp: new Date(this.now()).toISOString(),\n      level,\n      message,\n      service: this.settings.serviceName,\n      environment: this.settings.environment,\n      component: this.options.component,\n      ...cleanAttributes(attributes),\n    };\n    const serialized = JSON.stringify(record);\n    if (level === \"warn\") {\n      console.warn(serialized);\n    } else if (level === \"error\") {\n      console.error(serialized);\n    } else {\n      console.log(serialized);\n    }\n  }\n\n  startSpan(name: string, attributes: Attributes = {}): Span {\n    const traceId = randomHex(16);\n    const spanId = randomHex(8);\n    const startMs = this.now();\n    let ended = false;\n    return {\n      traceId,\n      spanId,\n      end: (input = {}) => {\n        if (ended) {\n          return;\n        }\n        ended = true;\n        const errorAttributes = input.error ? errorToAttributes(input.error) : {};\n        this.exportSpan({\n          traceId,\n          spanId,\n          name,\n          startMs,\n          endMs: this.now(),\n          attributes: {\n            ...attributes,\n            ...input.attributes,\n            ...errorAttributes,\n          },\n          error: input.error,\n        });\n      },\n    };\n  }\n\n  recordHttpRequest(input: { method: string; route: string; status: number; durationSeconds: number }): void {\n    if (!this.settings.observabilityMetricsEnabled) {\n      return;\n    }\n    const labels = {\n      method: input.method,\n      route: input.route,\n      status: String(input.status),\n      component: this.options.component,\n    };\n    this.metrics.increment(\"opengeni_http_requests_total\", labels);\n    this.metrics.observe(\"opengeni_http_request_duration_seconds\", histogramBuckets, input.durationSeconds, {\n      method: input.method,\n      route: input.route,\n      component: this.options.component,\n    });\n  }\n\n  recordWorkerActivity(input: { activity: string; status: string; durationSeconds: number }): void {\n    if (!this.settings.observabilityMetricsEnabled) {\n      return;\n    }\n    const labels = {\n      activity: input.activity,\n      status: input.status,\n      component: this.options.component,\n    };\n    this.metrics.increment(\"opengeni_worker_activity_runs_total\", labels);\n    this.metrics.observe(\"opengeni_worker_activity_duration_seconds\", histogramBuckets, input.durationSeconds, {\n      activity: input.activity,\n      component: this.options.component,\n    });\n  }\n\n  prometheusMetrics(): string {\n    return this.metrics.toPrometheus({\n      service: this.settings.serviceName,\n      environment: this.settings.environment,\n      component: this.options.component,\n    });\n  }\n\n  private exportSpan(span: {\n    traceId: string;\n    spanId: string;\n    name: string;\n    startMs: number;\n    endMs: number;\n    attributes: Attributes;\n    error?: unknown;\n  }): void {\n    if (!this.settings.observabilityOtlpEndpoint) {\n      return;\n    }\n    const endpoint = `${this.settings.observabilityOtlpEndpoint.replace(/\\/$/, \"\")}/v1/traces`;\n    const body = {\n      resourceSpans: [{\n        resource: {\n          attributes: otlpAttributes(this.resourceAttributes),\n        },\n        scopeSpans: [{\n          scope: {\n            name: \"@opengeni/observability\",\n            version: \"0.1.0\",\n          },\n          spans: [{\n            traceId: span.traceId,\n            spanId: span.spanId,\n            name: span.name,\n            kind: 1,\n            startTimeUnixNano: millisToNanos(span.startMs),\n            endTimeUnixNano: millisToNanos(span.endMs),\n            attributes: otlpAttributes(span.attributes),\n            status: span.error ? { code: 2, message: errorMessage(span.error) } : { code: 1 },\n          }],\n        }],\n      }],\n    };\n    void this.exporter(endpoint, body, parseHeaders(this.settings.observabilityOtlpHeaders)).catch((error) => {\n      this.warn(\"OTLP span export failed\", { error: errorMessage(error), endpoint });\n    });\n  }\n}\n\nexport type StartupDependencyRetryEvent = {\n  label: string;\n  attempt: number;\n  attempts: number;\n  delayMs: number;\n  error: unknown;\n};\n\nexport function logStartupDependencyRetry(observability: Observability, event: StartupDependencyRetryEvent): void {\n  const message = event.error instanceof Error ? event.error.message : String(event.error);\n  observability.warn(\"Startup dependency connection failed; retrying\", {\n    dependency: event.label,\n    attempt: event.attempt,\n    attempts: event.attempts,\n    delayMs: event.delayMs,\n    error: message,\n  });\n}\n\nclass MetricsRegistry {\n  private readonly counters = new Map<string, number>();\n  private readonly histograms = new Map<string, { buckets: number[]; counts: number[]; sum: number; count: number; labels: Record<string, string> }>();\n\n  increment(name: string, labels: Record<string, string>, amount = 1): void {\n    const key = metricKey(name, labels);\n    this.counters.set(key, (this.counters.get(key) ?? 0) + amount);\n  }\n\n  observe(name: string, buckets: number[], value: number, labels: Record<string, string>): void {\n    const key = metricKey(name, labels);\n    const histogram = this.histograms.get(key) ?? {\n      buckets,\n      counts: buckets.map(() => 0),\n      sum: 0,\n      count: 0,\n      labels,\n    };\n    histogram.sum += value;\n    histogram.count += 1;\n    for (let index = 0; index < buckets.length; index += 1) {\n      if (value <= buckets[index]!) {\n        histogram.counts[index] = (histogram.counts[index] ?? 0) + 1;\n      }\n    }\n    this.histograms.set(key, histogram);\n  }\n\n  toPrometheus(resourceLabels: Record<string, string>): string {\n    const lines = [\n      \"# HELP opengeni_http_requests_total Total HTTP requests handled by the OpenGeni API.\",\n      \"# TYPE opengeni_http_requests_total counter\",\n    ];\n    for (const [key, value] of this.counters) {\n      const { name, labels } = parseMetricKey(key);\n      if (name.endsWith(\"_total\")) {\n        lines.push(`${name}${formatLabels({ ...resourceLabels, ...labels })} ${value}`);\n      }\n    }\n    lines.push(\n      \"# HELP opengeni_http_request_duration_seconds HTTP request duration in seconds.\",\n      \"# TYPE opengeni_http_request_duration_seconds histogram\",\n      \"# HELP opengeni_worker_activity_runs_total Total worker activity executions.\",\n      \"# TYPE opengeni_worker_activity_runs_total counter\",\n      \"# HELP opengeni_worker_activity_duration_seconds Worker activity duration in seconds.\",\n      \"# TYPE opengeni_worker_activity_duration_seconds histogram\",\n    );\n    for (const [key, histogram] of this.histograms) {\n      const { name, labels } = parseMetricKey(key);\n      const baseLabels = { ...resourceLabels, ...labels };\n      for (let index = 0; index < histogram.buckets.length; index += 1) {\n        lines.push(`${name}_bucket${formatLabels({ ...baseLabels, le: String(histogram.buckets[index]) })} ${histogram.counts[index]}`);\n      }\n      lines.push(`${name}_bucket${formatLabels({ ...baseLabels, le: \"+Inf\" })} ${histogram.count}`);\n      lines.push(`${name}_sum${formatLabels(baseLabels)} ${histogram.sum}`);\n      lines.push(`${name}_count${formatLabels(baseLabels)} ${histogram.count}`);\n    }\n    return `${lines.join(\"\\n\")}\\n`;\n  }\n}\n\nfunction metricKey(name: string, labels: Record<string, string>): string {\n  return JSON.stringify({ name, labels: Object.fromEntries(Object.entries(labels).sort(([a], [b]) => a.localeCompare(b))) });\n}\n\nfunction parseMetricKey(key: string): { name: string; labels: Record<string, string> } {\n  return JSON.parse(key) as { name: string; labels: Record<string, string> };\n}\n\nfunction formatLabels(labels: Record<string, string>): string {\n  const entries = Object.entries(labels).filter(([, value]) => value.length > 0);\n  if (entries.length === 0) {\n    return \"\";\n  }\n  return `{${entries.map(([key, value]) => `${key}=\"${escapeMetricLabel(value)}\"`).join(\",\")}}`;\n}\n\nfunction escapeMetricLabel(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, \"\\\\\\\"\").replace(/\\n/g, \"\\\\n\");\n}\n\nfunction cleanAttributes(attributes: Attributes): Record<string, string | number | boolean | null> {\n  return Object.fromEntries(Object.entries(attributes).filter(([, value]) => value !== undefined)) as Record<string, string | number | boolean | null>;\n}\n\nfunction errorToAttributes(error: unknown): Attributes {\n  return {\n    \"error.type\": error instanceof Error ? error.name : \"Error\",\n    \"error.message\": errorMessage(error),\n  };\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction otlpAttributes(attributes: Attributes): Array<{ key: string; value: Record<string, string | number | boolean> }> {\n  return Object.entries(cleanAttributes(attributes)).map(([key, value]) => ({\n    key,\n    value: otlpValue(value),\n  }));\n}\n\nfunction otlpValue(value: string | number | boolean | null): Record<string, string | number | boolean> {\n  if (typeof value === \"number\") {\n    return Number.isInteger(value) ? { intValue: value } : { doubleValue: value };\n  }\n  if (typeof value === \"boolean\") {\n    return { boolValue: value };\n  }\n  return { stringValue: value === null ? \"\" : value };\n}\n\nfunction millisToNanos(ms: number): string {\n  return String(BigInt(Math.round(ms)) * 1_000_000n);\n}\n\nfunction randomHex(bytes: number): string {\n  const values = crypto.getRandomValues(new Uint8Array(bytes));\n  return Array.from(values, (value) => value.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\nexport function parseHeaders(value: string): Record<string, string> {\n  if (!value.trim()) {\n    return {};\n  }\n  const entries: Array<[string, string]> = value.split(\",\").map((pair): [string, string] => {\n    const separator = pair.indexOf(\"=\");\n    if (separator === -1) {\n      return [pair.trim(), \"\"];\n    }\n    return [pair.slice(0, separator).trim(), pair.slice(separator + 1).trim()];\n  }).filter(([key]) => key.length > 0);\n  return Object.fromEntries(entries);\n}\n\nasync function defaultExporter(url: string, body: unknown, headers: Record<string, string>): Promise<void> {\n  const response = await fetch(url, {\n    method: \"POST\",\n    headers: {\n      \"content-type\": \"application/json\",\n      ...headers,\n    },\n    body: JSON.stringify(body),\n  });\n  if (!response.ok) {\n    throw new Error(`OTLP endpoint returned HTTP ${response.status}`);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  collectDefaultMetrics,\n  Counter,\n  Gauge,\n  Histogram,\n  Registry,\n} from \"prom-client\";\n\nexport type AttributeValue = string | number | boolean | null | undefined;\nexport type Attributes = Record<string, AttributeValue>;\n\nexport type ObservabilitySettings = {\n  serviceName: string;\n  environment: string;\n  deploymentRevision?: string | undefined;\n  observabilityStructuredLogs: boolean;\n  observabilityMetricsEnabled: boolean;\n  observabilityOtlpEndpoint?: string | undefined;\n  observabilityOtlpHeaders: string;\n};\n\nexport type ObservabilityOptions = {\n  component: string;\n  now?: () => number;\n  exporter?: (url: string, body: unknown, headers: Record<string, string>) => Promise<void>;\n};\n\nexport type Span = {\n  traceId: string;\n  spanId: string;\n  end: (input?: { attributes?: Attributes; error?: unknown }) => void;\n};\n\nexport type MetricLabels = Record<string, AttributeValue>;\n\nconst httpHistogramBuckets = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];\nconst durationHistogramBuckets = [0.01, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10, 30, 60, 120, 300, 900, 1800, 3600];\n\nexport function createObservability(settings: ObservabilitySettings, options: ObservabilityOptions): Observability {\n  return new Observability(settings, options);\n}\n\ntype MetricRegistration = {\n  kind: \"counter\" | \"gauge\" | \"histogram\";\n  labelNames: string[];\n};\n\nexport class Observability {\n  private readonly registry = new Registry();\n  private readonly counters = new Map<string, Counter<string>>();\n  private readonly gauges = new Map<string, Gauge<string>>();\n  private readonly histograms = new Map<string, Histogram<string>>();\n  private readonly registrations = new Map<string, MetricRegistration>();\n  private readonly now: () => number;\n  private readonly exporter: (url: string, body: unknown, headers: Record<string, string>) => Promise<void>;\n  private readonly resourceAttributes: Attributes;\n\n  constructor(private readonly settings: ObservabilitySettings, private readonly options: ObservabilityOptions) {\n    this.now = options.now ?? Date.now;\n    this.exporter = options.exporter ?? defaultExporter;\n    this.resourceAttributes = {\n      \"service.name\": settings.serviceName,\n      \"deployment.environment\": settings.environment,\n      \"opengeni.component\": options.component,\n    };\n    this.registry.setDefaultLabels({\n      service: settings.serviceName,\n      environment: settings.environment,\n      component: options.component,\n    });\n    if (settings.observabilityMetricsEnabled) {\n      collectDefaultMetrics({ register: this.registry, prefix: \"opengeni_\" });\n      this.setGauge({\n        name: \"opengeni_build_info\",\n        help: \"OpenGeni build information.\",\n        labels: {\n          version: buildVersion(),\n          revision: settings.deploymentRevision ?? \"dev\",\n        },\n        value: 1,\n      });\n    }\n  }\n\n  debug(message: string, attributes: Attributes = {}): void {\n    this.log(\"debug\", message, attributes);\n  }\n\n  info(message: string, attributes: Attributes = {}): void {\n    this.log(\"info\", message, attributes);\n  }\n\n  warn(message: string, attributes: Attributes = {}): void {\n    this.log(\"warn\", message, attributes);\n  }\n\n  error(message: string, attributes: Attributes = {}): void {\n    this.log(\"error\", message, attributes);\n  }\n\n  log(level: \"debug\" | \"info\" | \"warn\" | \"error\", message: string, attributes: Attributes = {}): void {\n    if (!this.settings.observabilityStructuredLogs) {\n      const line = attributes.error ? `${message}: ${String(attributes.error)}` : message;\n      if (level === \"warn\") {\n        console.warn(line);\n      } else if (level === \"error\") {\n        console.error(line);\n      } else {\n        console.log(line);\n      }\n      return;\n    }\n    const record = {\n      timestamp: new Date(this.now()).toISOString(),\n      level,\n      message,\n      service: this.settings.serviceName,\n      environment: this.settings.environment,\n      component: this.options.component,\n      ...cleanAttributes(attributes),\n    };\n    const serialized = JSON.stringify(record);\n    if (level === \"warn\") {\n      console.warn(serialized);\n    } else if (level === \"error\") {\n      console.error(serialized);\n    } else {\n      console.log(serialized);\n    }\n  }\n\n  startSpan(name: string, attributes: Attributes = {}): Span {\n    const traceId = randomHex(16);\n    const spanId = randomHex(8);\n    const startMs = this.now();\n    let ended = false;\n    return {\n      traceId,\n      spanId,\n      end: (input = {}) => {\n        if (ended) {\n          return;\n        }\n        ended = true;\n        const errorAttributes = input.error ? errorToAttributes(input.error) : {};\n        this.exportSpan({\n          traceId,\n          spanId,\n          name,\n          startMs,\n          endMs: this.now(),\n          attributes: {\n            ...attributes,\n            ...input.attributes,\n            ...errorAttributes,\n          },\n          error: input.error,\n        });\n      },\n    };\n  }\n\n  recordHttpRequest(input: { method: string; route: string; status: number; durationSeconds: number }): void {\n    this.incrementCounter({\n      name: \"opengeni_http_requests_total\",\n      help: \"Total HTTP requests handled by OpenGeni.\",\n      labels: {\n        method: input.method,\n        route: input.route,\n        status: String(input.status),\n        component: this.options.component,\n      },\n    });\n    this.observeHistogram({\n      name: \"opengeni_http_request_duration_seconds\",\n      help: \"HTTP request duration in seconds.\",\n      buckets: httpHistogramBuckets,\n      value: input.durationSeconds,\n      labels: {\n        method: input.method,\n        route: input.route,\n        component: this.options.component,\n      },\n    });\n  }\n\n  recordWorkerActivity(input: { activity: string; status: string; durationSeconds: number }): void {\n    this.incrementCounter({\n      name: \"opengeni_worker_activity_runs_total\",\n      help: \"Total worker activity executions.\",\n      labels: {\n        activity: input.activity,\n        status: input.status,\n        component: this.options.component,\n      },\n    });\n    this.observeHistogram({\n      name: \"opengeni_worker_activity_duration_seconds\",\n      help: \"Worker activity duration in seconds.\",\n      buckets: durationHistogramBuckets,\n      value: input.durationSeconds,\n      labels: {\n        activity: input.activity,\n        component: this.options.component,\n      },\n    });\n  }\n\n  incrementCounter(input: { name: string; help?: string; labels?: MetricLabels; amount?: number }): void {\n    if (!this.settings.observabilityMetricsEnabled) {\n      return;\n    }\n    const labels = normalizeLabels(input.labels);\n    const counter = this.counter(input.name, input.help ?? `${input.name} counter.`, Object.keys(labels));\n    counter.inc(labels as never, input.amount ?? 1);\n  }\n\n  setGauge(input: { name: string; help?: string; labels?: MetricLabels; value: number }): void {\n    if (!this.settings.observabilityMetricsEnabled) {\n      return;\n    }\n    const labels = normalizeLabels(input.labels);\n    const gauge = this.gauge(input.name, input.help ?? `${input.name} gauge.`, Object.keys(labels));\n    gauge.set(labels as never, input.value);\n  }\n\n  incrementGauge(input: { name: string; help?: string; labels?: MetricLabels; amount?: number }): void {\n    if (!this.settings.observabilityMetricsEnabled) {\n      return;\n    }\n    const labels = normalizeLabels(input.labels);\n    const gauge = this.gauge(input.name, input.help ?? `${input.name} gauge.`, Object.keys(labels));\n    gauge.inc(labels as never, input.amount ?? 1);\n  }\n\n  observeHistogram(input: { name: string; help?: string; labels?: MetricLabels; value: number; buckets?: number[] }): void {\n    if (!this.settings.observabilityMetricsEnabled) {\n      return;\n    }\n    const labels = normalizeLabels(input.labels);\n    const histogram = this.histogram(\n      input.name,\n      input.help ?? `${input.name} histogram.`,\n      Object.keys(labels),\n      input.buckets ?? durationHistogramBuckets,\n    );\n    histogram.observe(labels as never, input.value);\n  }\n\n  async prometheusMetrics(): Promise<string> {\n    if (!this.settings.observabilityMetricsEnabled) {\n      return \"\";\n    }\n    return await this.registry.metrics();\n  }\n\n  private counter(name: string, help: string, labelNames: string[]): Counter<string> {\n    const existing = this.counters.get(name);\n    if (existing) {\n      this.assertRegistration(name, \"counter\", labelNames);\n      return existing;\n    }\n    this.register(name, \"counter\", labelNames);\n    const metric = new Counter({ name, help, labelNames, registers: [this.registry] });\n    this.counters.set(name, metric);\n    return metric;\n  }\n\n  private gauge(name: string, help: string, labelNames: string[]): Gauge<string> {\n    const existing = this.gauges.get(name);\n    if (existing) {\n      this.assertRegistration(name, \"gauge\", labelNames);\n      return existing;\n    }\n    this.register(name, \"gauge\", labelNames);\n    const metric = new Gauge({ name, help, labelNames, registers: [this.registry] });\n    this.gauges.set(name, metric);\n    return metric;\n  }\n\n  private histogram(name: string, help: string, labelNames: string[], buckets: number[]): Histogram<string> {\n    const existing = this.histograms.get(name);\n    if (existing) {\n      this.assertRegistration(name, \"histogram\", labelNames);\n      return existing;\n    }\n    this.register(name, \"histogram\", labelNames);\n    const metric = new Histogram({ name, help, labelNames, buckets, registers: [this.registry] });\n    this.histograms.set(name, metric);\n    return metric;\n  }\n\n  private register(name: string, kind: MetricRegistration[\"kind\"], labelNames: string[]): void {\n    const sorted = [...labelNames].sort();\n    this.registrations.set(name, { kind, labelNames: sorted });\n  }\n\n  private assertRegistration(name: string, kind: MetricRegistration[\"kind\"], labelNames: string[]): void {\n    const registration = this.registrations.get(name);\n    const sorted = [...labelNames].sort();\n    if (\n      !registration\n      || registration.kind !== kind\n      || registration.labelNames.length !== sorted.length\n      || registration.labelNames.some((label, index) => label !== sorted[index])\n    ) {\n      throw new Error(\n        `Metric ${name} was already registered as ${registration?.kind ?? \"unknown\"} `\n        + `with labels [${registration?.labelNames.join(\",\") ?? \"\"}], not ${kind} [${sorted.join(\",\")}]`,\n      );\n    }\n  }\n\n  private exportSpan(span: {\n    traceId: string;\n    spanId: string;\n    name: string;\n    startMs: number;\n    endMs: number;\n    attributes: Attributes;\n    error?: unknown;\n  }): void {\n    if (!this.settings.observabilityOtlpEndpoint) {\n      return;\n    }\n    const endpoint = `${this.settings.observabilityOtlpEndpoint.replace(/\\/$/, \"\")}/v1/traces`;\n    const body = {\n      resourceSpans: [{\n        resource: {\n          attributes: otlpAttributes(this.resourceAttributes),\n        },\n        scopeSpans: [{\n          scope: {\n            name: \"@opengeni/observability\",\n            version: \"0.1.0\",\n          },\n          spans: [{\n            traceId: span.traceId,\n            spanId: span.spanId,\n            name: span.name,\n            kind: 1,\n            startTimeUnixNano: millisToNanos(span.startMs),\n            endTimeUnixNano: millisToNanos(span.endMs),\n            attributes: otlpAttributes(span.attributes),\n            status: span.error ? { code: 2, message: errorMessage(span.error) } : { code: 1 },\n          }],\n        }],\n      }],\n    };\n    void this.exporter(endpoint, body, parseHeaders(this.settings.observabilityOtlpHeaders)).catch((error) => {\n      this.warn(\"OTLP span export failed\", { error: errorMessage(error), endpoint });\n    });\n  }\n}\n\nexport type StartupDependencyRetryEvent = {\n  label: string;\n  attempt: number;\n  attempts: number;\n  delayMs: number;\n  error: unknown;\n};\n\nexport function logStartupDependencyRetry(observability: Observability, event: StartupDependencyRetryEvent): void {\n  const message = event.error instanceof Error ? event.error.message : String(event.error);\n  observability.warn(\"Startup dependency connection failed; retrying\", {\n    dependency: event.label,\n    attempt: event.attempt,\n    attempts: event.attempts,\n    delayMs: event.delayMs,\n    error: message,\n  });\n}\n\nfunction normalizeLabels(labels: MetricLabels = {}): Record<string, string> {\n  return Object.fromEntries(\n    Object.entries(labels)\n      .filter(([, value]) => value !== undefined && value !== null)\n      .map(([key, value]): [string, string] => [key, String(value)])\n      .sort((left, right) => left[0].localeCompare(right[0])),\n  );\n}\n\nfunction buildVersion(): string {\n  return process.env.OPENGENI_VERSION\n    ?? process.env.npm_package_version\n    ?? \"dev\";\n}\n\nfunction cleanAttributes(attributes: Attributes): Record<string, string | number | boolean | null> {\n  return Object.fromEntries(Object.entries(attributes).filter(([, value]) => value !== undefined)) as Record<string, string | number | boolean | null>;\n}\n\nfunction errorToAttributes(error: unknown): Attributes {\n  return {\n    \"error.type\": error instanceof Error ? error.name : \"Error\",\n    \"error.message\": errorMessage(error),\n  };\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction otlpAttributes(attributes: Attributes): Array<{ key: string; value: Record<string, string | number | boolean> }> {\n  return Object.entries(cleanAttributes(attributes)).map(([key, value]) => ({\n    key,\n    value: otlpValue(value),\n  }));\n}\n\nfunction otlpValue(value: string | number | boolean | null): Record<string, string | number | boolean> {\n  if (typeof value === \"number\") {\n    return Number.isInteger(value) ? { intValue: value } : { doubleValue: value };\n  }\n  if (typeof value === \"boolean\") {\n    return { boolValue: value };\n  }\n  return { stringValue: value === null ? \"\" : value };\n}\n\nfunction millisToNanos(ms: number): string {\n  return String(BigInt(Math.round(ms)) * 1_000_000n);\n}\n\nfunction randomHex(bytes: number): string {\n  const values = crypto.getRandomValues(new Uint8Array(bytes));\n  return Array.from(values, (value) => value.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\nexport function parseHeaders(value: string): Record<string, string> {\n  if (!value.trim()) {\n    return {};\n  }\n  const entries: Array<[string, string]> = value.split(\",\").map((pair): [string, string] => {\n    const separator = pair.indexOf(\"=\");\n    if (separator === -1) {\n      return [pair.trim(), \"\"];\n    }\n    return [pair.slice(0, separator).trim(), pair.slice(separator + 1).trim()];\n  }).filter(([key]) => key.length > 0);\n  return Object.fromEntries(entries);\n}\n\nasync function defaultExporter(url: string, body: unknown, headers: Record<string, string>): Promise<void> {\n  const response = await fetch(url, {\n    method: \"POST\",\n    headers: {\n      \"content-type\": \"application/json\",\n      ...headers,\n    },\n    body: JSON.stringify(body),\n  });\n  if (!response.ok) {\n    throw new Error(`OTLP endpoint returned HTTP ${response.status}`);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@opengeni/observability",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
+  "license": "Apache-2.0",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,15 +22,15 @@
   },
   "scripts": {
     "build": "tsup",
-    "typecheck": "tsc --noEmit"
-  },
-  "devDependencies": {
-    "tsup": "^8.5.0",
-    "typescript": "^6.0.3"
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bash ../../scripts/prepublish-guard"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Cloudgeni-ai/opengeni.git",
     "directory": "packages/observability"
+  },
+  "dependencies": {
+    "prom-client": "^15.1.3"
   }
 }

package/src/index.ts

@@ -1,9 +1,18 @@
+import {
+  collectDefaultMetrics,
+  Counter,
+  Gauge,
+  Histogram,
+  Registry,
+} from "prom-client";
+
 export type AttributeValue = string | number | boolean | null | undefined;
 export type Attributes = Record<string, AttributeValue>;
 
 export type ObservabilitySettings = {
   serviceName: string;
   environment: string;
+  deploymentRevision?: string | undefined;
   observabilityStructuredLogs: boolean;
   observabilityMetricsEnabled: boolean;
   observabilityOtlpEndpoint?: string | undefined;
@@ -22,14 +31,26 @@ export type Span = {
   end: (input?: { attributes?: Attributes; error?: unknown }) => void;
 };
 
-const histogramBuckets = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+export type MetricLabels = Record<string, AttributeValue>;
+
+const httpHistogramBuckets = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+const durationHistogramBuckets = [0.01, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10, 30, 60, 120, 300, 900, 1800, 3600];
 
 export function createObservability(settings: ObservabilitySettings, options: ObservabilityOptions): Observability {
   return new Observability(settings, options);
 }
 
+type MetricRegistration = {
+  kind: "counter" | "gauge" | "histogram";
+  labelNames: string[];
+};
+
 export class Observability {
-  private readonly metrics = new MetricsRegistry();
+  private readonly registry = new Registry();
+  private readonly counters = new Map<string, Counter<string>>();
+  private readonly gauges = new Map<string, Gauge<string>>();
+  private readonly histograms = new Map<string, Histogram<string>>();
+  private readonly registrations = new Map<string, MetricRegistration>();
   private readonly now: () => number;
   private readonly exporter: (url: string, body: unknown, headers: Record<string, string>) => Promise<void>;
   private readonly resourceAttributes: Attributes;
@@ -42,6 +63,27 @@ export class Observability {
       "deployment.environment": settings.environment,
       "opengeni.component": options.component,
     };
+    this.registry.setDefaultLabels({
+      service: settings.serviceName,
+      environment: settings.environment,
+      component: options.component,
+    });
+    if (settings.observabilityMetricsEnabled) {
+      collectDefaultMetrics({ register: this.registry, prefix: "opengeni_" });
+      this.setGauge({
+        name: "opengeni_build_info",
+        help: "OpenGeni build information.",
+        labels: {
+          version: buildVersion(),
+          revision: settings.deploymentRevision ?? "dev",
+        },
+        value: 1,
+      });
+    }
+  }
+
+  debug(message: string, attributes: Attributes = {}): void {
+    this.log("debug", message, attributes);
   }
 
   info(message: string, attributes: Attributes = {}): void {
@@ -119,45 +161,154 @@ export class Observability {
   }
 
   recordHttpRequest(input: { method: string; route: string; status: number; durationSeconds: number }): void {
+    this.incrementCounter({
+      name: "opengeni_http_requests_total",
+      help: "Total HTTP requests handled by OpenGeni.",
+      labels: {
+        method: input.method,
+        route: input.route,
+        status: String(input.status),
+        component: this.options.component,
+      },
+    });
+    this.observeHistogram({
+      name: "opengeni_http_request_duration_seconds",
+      help: "HTTP request duration in seconds.",
+      buckets: httpHistogramBuckets,
+      value: input.durationSeconds,
+      labels: {
+        method: input.method,
+        route: input.route,
+        component: this.options.component,
+      },
+    });
+  }
+
+  recordWorkerActivity(input: { activity: string; status: string; durationSeconds: number }): void {
+    this.incrementCounter({
+      name: "opengeni_worker_activity_runs_total",
+      help: "Total worker activity executions.",
+      labels: {
+        activity: input.activity,
+        status: input.status,
+        component: this.options.component,
+      },
+    });
+    this.observeHistogram({
+      name: "opengeni_worker_activity_duration_seconds",
+      help: "Worker activity duration in seconds.",
+      buckets: durationHistogramBuckets,
+      value: input.durationSeconds,
+      labels: {
+        activity: input.activity,
+        component: this.options.component,
+      },
+    });
+  }
+
+  incrementCounter(input: { name: string; help?: string; labels?: MetricLabels; amount?: number }): void {
     if (!this.settings.observabilityMetricsEnabled) {
       return;
     }
-    const labels = {
-      method: input.method,
-      route: input.route,
-      status: String(input.status),
-      component: this.options.component,
-    };
-    this.metrics.increment("opengeni_http_requests_total", labels);
-    this.metrics.observe("opengeni_http_request_duration_seconds", histogramBuckets, input.durationSeconds, {
-      method: input.method,
-      route: input.route,
-      component: this.options.component,
-    });
+    const labels = normalizeLabels(input.labels);
+    const counter = this.counter(input.name, input.help ?? `${input.name} counter.`, Object.keys(labels));
+    counter.inc(labels as never, input.amount ?? 1);
   }
 
-  recordWorkerActivity(input: { activity: string; status: string; durationSeconds: number }): void {
+  setGauge(input: { name: string; help?: string; labels?: MetricLabels; value: number }): void {
     if (!this.settings.observabilityMetricsEnabled) {
       return;
     }
-    const labels = {
-      activity: input.activity,
-      status: input.status,
-      component: this.options.component,
-    };
-    this.metrics.increment("opengeni_worker_activity_runs_total", labels);
-    this.metrics.observe("opengeni_worker_activity_duration_seconds", histogramBuckets, input.durationSeconds, {
-      activity: input.activity,
-      component: this.options.component,
-    });
+    const labels = normalizeLabels(input.labels);
+    const gauge = this.gauge(input.name, input.help ?? `${input.name} gauge.`, Object.keys(labels));
+    gauge.set(labels as never, input.value);
   }
 
-  prometheusMetrics(): string {
-    return this.metrics.toPrometheus({
-      service: this.settings.serviceName,
-      environment: this.settings.environment,
-      component: this.options.component,
-    });
+  incrementGauge(input: { name: string; help?: string; labels?: MetricLabels; amount?: number }): void {
+    if (!this.settings.observabilityMetricsEnabled) {
+      return;
+    }
+    const labels = normalizeLabels(input.labels);
+    const gauge = this.gauge(input.name, input.help ?? `${input.name} gauge.`, Object.keys(labels));
+    gauge.inc(labels as never, input.amount ?? 1);
+  }
+
+  observeHistogram(input: { name: string; help?: string; labels?: MetricLabels; value: number; buckets?: number[] }): void {
+    if (!this.settings.observabilityMetricsEnabled) {
+      return;
+    }
+    const labels = normalizeLabels(input.labels);
+    const histogram = this.histogram(
+      input.name,
+      input.help ?? `${input.name} histogram.`,
+      Object.keys(labels),
+      input.buckets ?? durationHistogramBuckets,
+    );
+    histogram.observe(labels as never, input.value);
+  }
+
+  async prometheusMetrics(): Promise<string> {
+    if (!this.settings.observabilityMetricsEnabled) {
+      return "";
+    }
+    return await this.registry.metrics();
+  }
+
+  private counter(name: string, help: string, labelNames: string[]): Counter<string> {
+    const existing = this.counters.get(name);
+    if (existing) {
+      this.assertRegistration(name, "counter", labelNames);
+      return existing;
+    }
+    this.register(name, "counter", labelNames);
+    const metric = new Counter({ name, help, labelNames, registers: [this.registry] });
+    this.counters.set(name, metric);
+    return metric;
+  }
+
+  private gauge(name: string, help: string, labelNames: string[]): Gauge<string> {
+    const existing = this.gauges.get(name);
+    if (existing) {
+      this.assertRegistration(name, "gauge", labelNames);
+      return existing;
+    }
+    this.register(name, "gauge", labelNames);
+    const metric = new Gauge({ name, help, labelNames, registers: [this.registry] });
+    this.gauges.set(name, metric);
+    return metric;
+  }
+
+  private histogram(name: string, help: string, labelNames: string[], buckets: number[]): Histogram<string> {
+    const existing = this.histograms.get(name);
+    if (existing) {
+      this.assertRegistration(name, "histogram", labelNames);
+      return existing;
+    }
+    this.register(name, "histogram", labelNames);
+    const metric = new Histogram({ name, help, labelNames, buckets, registers: [this.registry] });
+    this.histograms.set(name, metric);
+    return metric;
+  }
+
+  private register(name: string, kind: MetricRegistration["kind"], labelNames: string[]): void {
+    const sorted = [...labelNames].sort();
+    this.registrations.set(name, { kind, labelNames: sorted });
+  }
+
+  private assertRegistration(name: string, kind: MetricRegistration["kind"], labelNames: string[]): void {
+    const registration = this.registrations.get(name);
+    const sorted = [...labelNames].sort();
+    if (
+      !registration
+      || registration.kind !== kind
+      || registration.labelNames.length !== sorted.length
+      || registration.labelNames.some((label, index) => label !== sorted[index])
+    ) {
+      throw new Error(
+        `Metric ${name} was already registered as ${registration?.kind ?? "unknown"} `
+        + `with labels [${registration?.labelNames.join(",") ?? ""}], not ${kind} [${sorted.join(",")}]`,
+      );
+    }
   }
 
   private exportSpan(span: {
@@ -221,85 +372,19 @@ export function logStartupDependencyRetry(observability: Observability, event: S
   });
 }
 
-class MetricsRegistry {
-  private readonly counters = new Map<string, number>();
-  private readonly histograms = new Map<string, { buckets: number[]; counts: number[]; sum: number; count: number; labels: Record<string, string> }>();
-
-  increment(name: string, labels: Record<string, string>, amount = 1): void {
-    const key = metricKey(name, labels);
-    this.counters.set(key, (this.counters.get(key) ?? 0) + amount);
-  }
-
-  observe(name: string, buckets: number[], value: number, labels: Record<string, string>): void {
-    const key = metricKey(name, labels);
-    const histogram = this.histograms.get(key) ?? {
-      buckets,
-      counts: buckets.map(() => 0),
-      sum: 0,
-      count: 0,
-      labels,
-    };
-    histogram.sum += value;
-    histogram.count += 1;
-    for (let index = 0; index < buckets.length; index += 1) {
-      if (value <= buckets[index]!) {
-        histogram.counts[index] = (histogram.counts[index] ?? 0) + 1;
-      }
-    }
-    this.histograms.set(key, histogram);
-  }
-
-  toPrometheus(resourceLabels: Record<string, string>): string {
-    const lines = [
-      "# HELP opengeni_http_requests_total Total HTTP requests handled by the OpenGeni API.",
-      "# TYPE opengeni_http_requests_total counter",
-    ];
-    for (const [key, value] of this.counters) {
-      const { name, labels } = parseMetricKey(key);
-      if (name.endsWith("_total")) {
-        lines.push(`${name}${formatLabels({ ...resourceLabels, ...labels })} ${value}`);
-      }
-    }
-    lines.push(
-      "# HELP opengeni_http_request_duration_seconds HTTP request duration in seconds.",
-      "# TYPE opengeni_http_request_duration_seconds histogram",
-      "# HELP opengeni_worker_activity_runs_total Total worker activity executions.",
-      "# TYPE opengeni_worker_activity_runs_total counter",
-      "# HELP opengeni_worker_activity_duration_seconds Worker activity duration in seconds.",
-      "# TYPE opengeni_worker_activity_duration_seconds histogram",
-    );
-    for (const [key, histogram] of this.histograms) {
-      const { name, labels } = parseMetricKey(key);
-      const baseLabels = { ...resourceLabels, ...labels };
-      for (let index = 0; index < histogram.buckets.length; index += 1) {
-        lines.push(`${name}_bucket${formatLabels({ ...baseLabels, le: String(histogram.buckets[index]) })} ${histogram.counts[index]}`);
-      }
-      lines.push(`${name}_bucket${formatLabels({ ...baseLabels, le: "+Inf" })} ${histogram.count}`);
-      lines.push(`${name}_sum${formatLabels(baseLabels)} ${histogram.sum}`);
-      lines.push(`${name}_count${formatLabels(baseLabels)} ${histogram.count}`);
-    }
-    return `${lines.join("\n")}\n`;
-  }
-}
-
-function metricKey(name: string, labels: Record<string, string>): string {
-  return JSON.stringify({ name, labels: Object.fromEntries(Object.entries(labels).sort(([a], [b]) => a.localeCompare(b))) });
-}
-
-function parseMetricKey(key: string): { name: string; labels: Record<string, string> } {
-  return JSON.parse(key) as { name: string; labels: Record<string, string> };
-}
-
-function formatLabels(labels: Record<string, string>): string {
-  const entries = Object.entries(labels).filter(([, value]) => value.length > 0);
-  if (entries.length === 0) {
-    return "";
-  }
-  return `{${entries.map(([key, value]) => `${key}="${escapeMetricLabel(value)}"`).join(",")}}`;
+function normalizeLabels(labels: MetricLabels = {}): Record<string, string> {
+  return Object.fromEntries(
+    Object.entries(labels)
+      .filter(([, value]) => value !== undefined && value !== null)
+      .map(([key, value]): [string, string] => [key, String(value)])
+      .sort((left, right) => left[0].localeCompare(right[0])),
+  );
 }
 
-function escapeMetricLabel(value: string): string {
-  return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n");
+function buildVersion(): string {
+  return process.env.OPENGENI_VERSION
+    ?? process.env.npm_package_version
+    ?? "dev";
 }
 
 function cleanAttributes(attributes: Attributes): Record<string, string | number | boolean | null> {