@bsb/base 9.0.0

package/lib/base/ObservableBackend.js

@@ -0,0 +1,515 @@
+"use strict";
+/**
+ * BSB (Better-Service-Base) is an event-bus based microservice framework.
+ * Copyright (C) 2016 - 2025 BetterCorp (PTY) Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alternatively, you may obtain a commercial license for this program.
+ * The commercial license allows you to use the Program in a closed-source manner,
+ * including the right to create derivative works that are not subject to the terms
+ * of the AGPL.
+ *
+ * To obtain a commercial license, please contact the copyright holders at
+ * https://www.bettercorp.dev. The terms and conditions of the commercial license
+ * will be provided upon request.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservableBackend = void 0;
+const uuid_1 = require("uuid");
+const tools_1 = require("./tools");
+const interfaces_1 = require("../interfaces");
+const errorMessages_1 = require("./errorMessages");
+const base_1 = require("./base");
+/**
+ * Generate OpenTelemetry-compliant trace ID (32 hex chars lowercase)
+ * @returns 32-character hexadecimal trace ID
+ */
+function generateTraceId() {
+    return (0, uuid_1.v7)().replace(/-/g, '').toLowerCase();
+}
+/**
+ * Generate OpenTelemetry-compliant span ID (16 hex chars lowercase)
+ * Uses random bytes to ensure uniqueness even for spans created at the same millisecond
+ * @returns 16-character hexadecimal span ID
+ */
+function generateSpanId() {
+    // Generate 8 random bytes (64 bits) = 16 hex characters
+    const bytes = new Uint8Array(8);
+    if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
+        crypto.getRandomValues(bytes);
+    }
+    else {
+        // Fallback for environments without crypto.getRandomValues
+        const nodeCrypto = require('crypto');
+        nodeCrypto.randomFillSync(bytes);
+    }
+    return Array.from(bytes)
+        .map(b => b.toString(16).padStart(2, '0'))
+        .join('')
+        .toLowerCase();
+}
+/**
+ * Normalize attribute keys by replacing symbols with underscores
+ * OpenTelemetry and many backends prefer snake_case attribute names
+ * @param attributes - Original attributes
+ * @returns Normalized attributes with safe key names
+ */
+function normalizeAttributes(attributes) {
+    if (!attributes)
+        return attributes;
+    const normalized = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        // Replace periods, colons, slashes, and spaces with underscores
+        const normalizedKey = key.replace(/[.:/\s-]/g, '_');
+        normalized[normalizedKey] = value;
+    }
+    return normalized;
+}
+/**
+ * @hidden
+ */
+function internalTrace(span) {
+    return (0, interfaces_1.createFakeDTrace)("base/ObservableBackend", span);
+}
+/**
+ * Represents a single span in a distributed trace
+ *
+ * A span tracks a specific operation within a trace, with a unique span ID.
+ * Spans form parent-child relationships to represent the call hierarchy.
+ *
+ * @internal
+ * @hidden
+ */
+class ObservableBackendSpan {
+    _traceId;
+    _spanId;
+    pluginName;
+    backend;
+    appId;
+    /**
+     * Create a new span
+     * @param backend - Observable backend for emitting span events
+     * @param appId - Application ID
+     * @param pluginName - Name of the plugin creating the span
+     * @param traceId - Trace ID (unique for the entire trace)
+     * @param parentSpanId - Parent span ID (null for root spans)
+     * @param spanId - This span's unique ID
+     * @param name - Name of the span (e.g., "database-query")
+     * @param attributes - Optional attributes to attach to the span
+     */
+    constructor(backend, appId, pluginName, traceId, parentSpanId, spanId, name, attributes) {
+        this.backend = backend;
+        this.appId = appId;
+        this.pluginName = pluginName;
+        this._traceId = traceId;
+        this._spanId = spanId;
+        // Normalize attribute keys for compatibility with observability backends
+        const normalizedAttrs = normalizeAttributes(attributes);
+        this.backend.startSpan(Date.now(), this.appId, this.pluginName, traceId, parentSpanId, spanId, name, normalizedAttrs);
+    }
+    /**
+     * Get the span ID
+     * @returns The unique span ID
+     */
+    get id() {
+        return this._spanId;
+    }
+    /**
+     * Get the DTrace object (trace ID + span ID)
+     * @returns DTrace object containing trace ID and span ID
+     */
+    get trace() {
+        return {
+            t: this._traceId,
+            s: this._spanId,
+        };
+    }
+    /**
+     * End the span
+     * @param attributes - Final attributes to attach before ending
+     */
+    end(attributes) {
+        const normalizedAttrs = normalizeAttributes(attributes);
+        this.backend.endSpan(Date.now(), this.appId, this.pluginName, this._traceId, this._spanId, normalizedAttrs);
+    }
+    /**
+     * Record an error on the span
+     * @param error - Error or BSBError to record
+     * @param attributes - Additional attributes to attach to the error
+     */
+    error(error, attributes) {
+        const normalizedAttrs = normalizeAttributes(attributes);
+        this.backend.errorSpan(Date.now(), this.appId, this.pluginName, this._traceId, this._spanId, error, normalizedAttrs);
+    }
+}
+/**
+ * Represents a complete trace with an associated span
+ *
+ * A trace represents the entire journey of a request through the system.
+ * Each trace contains one or more spans representing individual operations.
+ *
+ * @internal
+ * @hidden
+ */
+class ObservableBackendTrace {
+    _traceId;
+    _span;
+    backend;
+    appId;
+    pluginName;
+    constructor(backend, appId, pluginName, trace, opts) {
+        this.backend = backend;
+        this.appId = appId;
+        this.pluginName = pluginName;
+        // Use OpenTelemetry-compliant IDs: trace ID (32 hex chars), span ID (16 hex chars)
+        this._traceId = trace?.t ?? generateTraceId();
+        const spanId = generateSpanId();
+        this._span = new ObservableBackendSpan(this.backend, this.appId, this.pluginName, this._traceId, trace?.s ?? null, spanId, opts.name, opts?.attributes);
+    }
+    /**
+     * Get the trace ID
+     * @returns The unique trace ID
+     */
+    get id() {
+        return this._traceId;
+    }
+    /**
+     * Record an error on the trace's span
+     * @param error - Error or BSBError to record
+     * @param attributes - Additional attributes to attach to the error
+     */
+    error(error, attributes) {
+        this._span.error(error, attributes);
+    }
+    /**
+     * Get the DTrace object (trace ID + current span ID)
+     * @returns DTrace object containing trace ID and current span ID
+     */
+    get trace() {
+        return { t: this._traceId, s: this._span.id };
+    }
+    /**
+     * End the trace by ending its associated span
+     * @param attributes - Final attributes to attach before ending
+     */
+    end(attributes) {
+        this._span.end(attributes);
+    }
+}
+/**
+ * Observable Backend - Unified backend for logging and metrics
+ *
+ * This is the internal backend that handles both logging and metrics operations.
+ * It replaces the separate PluginLogging and PluginMetrics classes with a single
+ * unified implementation.
+ *
+ * @group Observable
+ * @category Plugin Development Tools
+ * @internal
+ *
+ * @example
+ * ```typescript
+ * // Internal use only - plugins use Observable interface
+ * const backend = new ObservableBackend(
+ *   'development',
+ *   'my-app',
+ *   'my-plugin',
+ *   sbObservable
+ * );
+ * ```
+ */
+class ObservableBackend {
+    bus;
+    pluginName;
+    appId;
+    canDebug = false;
+    /**
+     * Create an ObservableBackend instance
+     * @param mode - Debug mode setting
+     * @param appId - Application ID
+     * @param pluginName - Plugin name
+     * @param bus - Observable bus for emitting events
+     */
+    constructor(mode, appId, pluginName, bus) {
+        this.bus = bus;
+        this.pluginName = pluginName;
+        this.appId = appId;
+        if (mode !== "production") {
+            this.canDebug = true;
+        }
+    }
+    // ==================== LOGGING METHODS ====================
+    /**
+     * Logs a debug message
+     *
+     * @param trace - The trace to associate with the log
+     * @param message - The message to log
+     * @param meta - Additional information to log with the message
+     * @returns nothing
+     *
+     * @example
+     * ```ts
+     * backend.debug(trace, "This is a debug log");
+     * backend.debug(trace, "This is a debug {key}", {"key": "log"});
+     * ```
+     */
+    debug(trace, message, ...meta) {
+        if (!this.canDebug)
+            return; // Early return for performance
+        this.bus.debug(this.pluginName, trace, message, ...meta);
+    }
+    /**
+     * Logs an info message
+     *
+     * @param trace - The trace to associate with the log
+     * @param message - The message to log
+     * @param meta - Additional information to log with the message
+     * @returns nothing
+     *
+     * @example
+     * ```ts
+     * backend.info(trace, "This is an info log");
+     * backend.info(trace, "This is an info {key}", {"key": "log"});
+     * ```
+     */
+    info(trace, message, ...meta) {
+        this.bus.info(this.pluginName, trace, message, ...meta);
+    }
+    /**
+     * Logs a warn message
+     *
+     * @param trace - The trace to associate with the log
+     * @param message - The message to log
+     * @param meta - Additional information to log with the message
+     * @returns nothing
+     *
+     * @example
+     * ```ts
+     * backend.warn(trace, "This is a warn log");
+     * backend.warn(trace, "This is a warn {key}", {"key": "log"});
+     * ```
+     */
+    warn(trace, message, ...meta) {
+        this.bus.warn(this.pluginName, trace, message, ...meta);
+    }
+    error(traceOrError, message, ...meta) {
+        if (traceOrError instanceof errorMessages_1.BSBError) {
+            if (traceOrError.raw !== null) {
+                this.bus.error(this.pluginName, traceOrError.raw.trace, traceOrError.raw.message, traceOrError.raw.meta);
+                return;
+            }
+            this.error((0, interfaces_1.createFakeDTrace)('base/ObservableBackend', 'error'), traceOrError.message + ' - error ');
+            return;
+        }
+        if (!tools_1.Tools.isObject(traceOrError) || !tools_1.Tools.isString(traceOrError.t) || !tools_1.Tools.isString(traceOrError.s)) {
+            this.error((0, interfaces_1.createFakeDTrace)('base/ObservableBackend', 'errorType'), JSON.stringify(traceOrError));
+            return;
+        }
+        this.bus.error(this.pluginName, traceOrError, message, ...meta);
+    }
+    // ==================== METRICS METHODS ====================
+    /**
+     * Create a counter metric
+     *
+     * Counters are monotonically increasing values used to track cumulative totals.
+     * Common uses: request counts, error counts, bytes processed.
+     *
+     * @param name - Metric name (e.g., "requests_total")
+     * @param description - Short description
+     * @param help - Detailed help text
+     * @param labels - Optional label names for dimensional metrics
+     * @returns Counter instance with increment method
+     *
+     * @example
+     * ```typescript
+     * const requests = backend.createCounter(
+     *   "http_requests_total",
+     *   "Total HTTP requests",
+     *   "Count of all HTTP requests received",
+     *   ["method", "status"]
+     * );
+     * requests.increment(1, { method: "GET", status: "200" });
+     * ```
+     */
+    createCounter(name, description, help, labels) {
+        if (!this.bus.isReady) {
+            throw new errorMessages_1.BSBError(internalTrace("createCounter"), "Metrics not ready!");
+        }
+        this.bus.createCounter(Date.now(), this.pluginName, name, description, help, labels);
+        return {
+            increment: (value = 1, labels) => {
+                this.bus.incrementCounter(Date.now(), this.pluginName, name, value, labels);
+            },
+        };
+    }
+    /**
+     * Create a gauge metric
+     *
+     * Gauges represent point-in-time values that can go up or down.
+     * Common uses: memory usage, active connections, queue depth, temperature.
+     *
+     * @param name - Metric name (e.g., "active_connections")
+     * @param description - Short description
+     * @param help - Detailed help text
+     * @param labels - Optional label names for dimensional metrics
+     * @returns Gauge instance with set, increment, and decrement methods
+     *
+     * @example
+     * ```typescript
+     * const activeConns = backend.createGauge(
+     *   "active_connections",
+     *   "Active connections",
+     *   "Number of currently active connections"
+     * );
+     * activeConns.set(42);
+     * activeConns.increment(1);
+     * activeConns.decrement(1);
+     * ```
+     */
+    createGauge(name, description, help, labels) {
+        if (!this.bus.isReady) {
+            throw new errorMessages_1.BSBError(internalTrace("createGauge"), "Metrics not ready!");
+        }
+        this.bus.createGauge(Date.now(), this.pluginName, name, description, help, labels);
+        return {
+            set: (value, labels) => {
+                this.bus.setGauge(Date.now(), this.pluginName, name, value, labels);
+            },
+            increment: (value = 1, labels) => {
+                // Note: Observable plugins should track current value and add internally
+                this.bus.setGauge(Date.now(), this.pluginName, name, value, labels);
+            },
+            decrement: (value = 1, labels) => {
+                // Note: Observable plugins should track current value and subtract internally
+                this.bus.setGauge(Date.now(), this.pluginName, name, -value, labels);
+            },
+        };
+    }
+    /**
+     * Create a histogram metric
+     *
+     * Histograms track the distribution of values over time.
+     * Common uses: request duration, response size, batch size.
+     *
+     * @param name - Metric name (e.g., "request_duration_ms")
+     * @param description - Short description
+     * @param help - Detailed help text
+     * @param boundaries - Optional bucket boundaries (default: [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10])
+     * @param labels - Optional label names for dimensional metrics
+     * @returns Histogram instance with record method
+     *
+     * @example
+     * ```typescript
+     * const duration = backend.createHistogram(
+     *   "request_duration_ms",
+     *   "Request duration",
+     *   "Duration of HTTP requests in milliseconds",
+     *   [10, 50, 100, 500, 1000, 5000],
+     *   ["method"]
+     * );
+     * duration.record(125, { method: "GET" });
+     * ```
+     */
+    createHistogram(name, description, help, boundaries, labels) {
+        if (!this.bus.isReady) {
+            throw new errorMessages_1.BSBError(internalTrace("createHistogram"), "Metrics not ready!");
+        }
+        this.bus.createHistogram(Date.now(), this.pluginName, name, description, help, boundaries, labels);
+        return {
+            record: (value, labels) => {
+                this.bus.observeHistogram(Date.now(), this.pluginName, name, value, labels);
+            },
+        };
+    }
+    /**
+     * Create a new distributed trace
+     *
+     * Creates a root trace with no parent. Use this when starting a new
+     * request or operation that should be tracked independently.
+     *
+     * @param name - Name of the trace/span (e.g., "http-request")
+     * @param attributes - Optional attributes to attach to the trace
+     * @returns Trace instance
+     *
+     * @example
+     * ```typescript
+     * const trace = backend.createTrace("process-batch", {
+     *   "batch.size": 100
+     * });
+     * // ... do work ...
+     * trace.end({ "batch.processed": 100 });
+     * ```
+     */
+    createTrace(name, attributes) {
+        if (!this.bus.isReady) {
+            throw new errorMessages_1.BSBError(internalTrace("createTrace"), "Metrics not ready!");
+        }
+        return new ObservableBackendTrace(this.bus, this.appId, this.pluginName, null, { name, attributes });
+    }
+    /**
+     * Create a child span within an existing trace
+     *
+     * Creates a child span that inherits the trace ID from the parent.
+     * This is used internally by Observable.startSpan().
+     *
+     * @param trace - Parent DTrace object
+     * @param name - Name of the span (e.g., "database-query")
+     * @param attributes - Optional attributes to attach to the span
+     * @returns Trace instance representing the child span
+     *
+     * @example
+     * ```typescript
+     * // Usually accessed via Observable
+     * const childSpan = backend.createSpan(trace, "database-query");
+     * // ... do work ...
+     * childSpan.end();
+     * ```
+     */
+    createSpan(trace, name, attributes) {
+        if (!this.bus.isReady) {
+            throw new errorMessages_1.BSBError(internalTrace("createSpan"), "Metrics not ready!");
+        }
+        return new ObservableBackendTrace(this.bus, this.appId, this.pluginName, trace, { name, attributes });
+    }
+    /**
+     * Create a high-resolution timer
+     *
+     * Returns a timer that can measure elapsed time in milliseconds with
+     * sub-millisecond precision using Node.js hrtime.
+     *
+     * @returns Timer instance with stop method
+     *
+     * @example
+     * ```typescript
+     * const timer = backend.createTimer();
+     * await performOperation();
+     * const elapsed = timer.stop();
+     * ```
+     */
+    createTimer() {
+        if (!this.bus.isReady) {
+            throw new errorMessages_1.BSBError(internalTrace("createTimer"), "Metrics not ready!");
+        }
+        const start = process.hrtime();
+        return {
+            stop: () => {
+                const diff = process.hrtime(start);
+                return (diff[0] * base_1.NS_PER_SEC + diff[1]) * base_1.MS_PER_NS;
+            }
+        };
+    }
+}
+exports.ObservableBackend = ObservableBackend;
+//# sourceMappingURL=ObservableBackend.js.map

package/lib/base/ObservableBackend.js.map

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