@foam-ai/node 0.1.0-alpha.2 → 0.1.0-alpha.3

package/dist/node/src/index.d.ts

@@ -1,9 +1,13 @@
 import { captureException } from './capture-exception';
 import { init } from './init';
-export { captureException, init };
+import { incrementCounter, recordHistogram, recordGauge } from './metrics';
+export { captureException, init, incrementCounter, recordHistogram, recordGauge };
 export type { FoamNodeInitOptions } from './init';
 declare const foam: {
     captureException: (error: unknown) => void;
     init: (options: import("./init").FoamNodeInitOptions) => void;
+    incrementCounter: (name: string, value?: number, attributes?: import("@opentelemetry/api").Attributes) => void;
+    recordHistogram: (name: string, value: number, attributes?: import("@opentelemetry/api").Attributes) => void;
+    recordGauge: (name: string, value: number, attributes?: import("@opentelemetry/api").Attributes) => void;
 };
 export default foam;

package/dist/node/src/index.js

@@ -1,12 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.init = exports.captureException = void 0;
+exports.recordGauge = exports.recordHistogram = exports.incrementCounter = exports.init = exports.captureException = void 0;
 const capture_exception_1 = require("./capture-exception");
 Object.defineProperty(exports, "captureException", { enumerable: true, get: function () { return capture_exception_1.captureException; } });
 const init_1 = require("./init");
 Object.defineProperty(exports, "init", { enumerable: true, get: function () { return init_1.init; } });
+const metrics_1 = require("./metrics");
+Object.defineProperty(exports, "incrementCounter", { enumerable: true, get: function () { return metrics_1.incrementCounter; } });
+Object.defineProperty(exports, "recordHistogram", { enumerable: true, get: function () { return metrics_1.recordHistogram; } });
+Object.defineProperty(exports, "recordGauge", { enumerable: true, get: function () { return metrics_1.recordGauge; } });
 const foam = {
     captureException: capture_exception_1.captureException,
     init: init_1.init,
+    incrementCounter: metrics_1.incrementCounter,
+    recordHistogram: metrics_1.recordHistogram,
+    recordGauge: metrics_1.recordGauge,
 };
 exports.default = foam;

package/dist/node/src/init.js

@@ -190,11 +190,16 @@ function patchConsole() {
         const original = console[method].bind(console);
         console[method] = (...args) => {
             original(...args);
-            const ctx = api_1.context.active();
-            const spanContext = api_1.trace.getSpanContext(ctx);
-            const traceAttributes = spanContext && (0, api_1.isSpanContextValid)(spanContext)
-                ? { 'trace.id': spanContext.traceId, 'span.id': spanContext.spanId }
-                : undefined;
+            let ctx;
+            let traceAttributes;
+            try {
+                ctx = api_1.context.active();
+                const spanContext = api_1.trace.getSpanContext(ctx);
+                if (spanContext && (0, api_1.isSpanContextValid)(spanContext)) {
+                    traceAttributes = { 'trace.id': spanContext.traceId, 'span.id': spanContext.spanId };
+                }
+            }
+            catch { /* never break the caller's console.log */ }
             logger.emit({
                 context: ctx,
                 severityNumber,

package/dist/node/src/metrics.d.ts

@@ -0,0 +1,28 @@
+import { type Attributes } from '@opentelemetry/api';
+/**
+ * Increments a counter metric by the given value (default 1).
+ *
+ * Counters are monotonically increasing — use for things like request counts,
+ * items processed, or errors encountered.
+ *
+ * Safe to call before `init()` — silently no-ops via the OTel noop meter.
+ */
+export declare const incrementCounter: (name: string, value?: number, attributes?: Attributes) => void;
+/**
+ * Records a value on a histogram metric.
+ *
+ * Histograms capture distributions — use for latencies, request sizes,
+ * or any measurement where percentiles and averages matter.
+ *
+ * Safe to call before `init()` — silently no-ops via the OTel noop meter.
+ */
+export declare const recordHistogram: (name: string, value: number, attributes?: Attributes) => void;
+/**
+ * Records a point-in-time gauge value.
+ *
+ * Gauges represent a current measurement that can go up or down — use for
+ * things like queue depth, active connections, or memory usage.
+ *
+ * Safe to call before `init()` — silently no-ops via the OTel noop meter.
+ */
+export declare const recordGauge: (name: string, value: number, attributes?: Attributes) => void;

package/dist/node/src/metrics.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordGauge = exports.recordHistogram = exports.incrementCounter = void 0;
+const api_1 = require("@opentelemetry/api");
+const util_1 = require("../../shared/util");
+const METER_NAME = 'foam';
+const counters = new Map();
+const histograms = new Map();
+const gauges = new Map();
+function getMeter() {
+    return api_1.metrics.getMeter(METER_NAME);
+}
+function getOrCreateCounter(name) {
+    let counter = counters.get(name);
+    if (!counter) {
+        counter = getMeter().createCounter(name);
+        counters.set(name, counter);
+    }
+    return counter;
+}
+function getOrCreateHistogram(name) {
+    let histogram = histograms.get(name);
+    if (!histogram) {
+        histogram = getMeter().createHistogram(name);
+        histograms.set(name, histogram);
+    }
+    return histogram;
+}
+function getOrCreateGauge(name) {
+    let gauge = gauges.get(name);
+    if (!gauge) {
+        gauge = getMeter().createGauge(name);
+        gauges.set(name, gauge);
+    }
+    return gauge;
+}
+/**
+ * Increments a counter metric by the given value (default 1).
+ *
+ * Counters are monotonically increasing — use for things like request counts,
+ * items processed, or errors encountered.
+ *
+ * Safe to call before `init()` — silently no-ops via the OTel noop meter.
+ */
+exports.incrementCounter = (0, util_1.safe)((name, value, attributes) => {
+    getOrCreateCounter(name).add(value ?? 1, attributes);
+});
+/**
+ * Records a value on a histogram metric.
+ *
+ * Histograms capture distributions — use for latencies, request sizes,
+ * or any measurement where percentiles and averages matter.
+ *
+ * Safe to call before `init()` — silently no-ops via the OTel noop meter.
+ */
+exports.recordHistogram = (0, util_1.safe)((name, value, attributes) => {
+    getOrCreateHistogram(name).record(value, attributes);
+});
+/**
+ * Records a point-in-time gauge value.
+ *
+ * Gauges represent a current measurement that can go up or down — use for
+ * things like queue depth, active connections, or memory usage.
+ *
+ * Safe to call before `init()` — silently no-ops via the OTel noop meter.
+ */
+exports.recordGauge = (0, util_1.safe)((name, value, attributes) => {
+    getOrCreateGauge(name).record(value, attributes);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foam-ai/node",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "main": "dist/node/src/index.js",
   "types": "dist/node/src/index.d.ts",
   "exports": {