@bsb/base 9.0.0

package/lib/serviceBase/observable.js

@@ -0,0 +1,551 @@
+"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.SBObservable = void 0;
+const node_events_1 = require("node:events");
+const base_1 = require("../base");
+const metrics_1 = require("../interfaces/metrics");
+const index_1 = require("../plugins/observable-default/index");
+/**
+ * @hidden
+ */
+function internalTrace(span) {
+    return (0, metrics_1.createFakeDTrace)("serviceBase/SBObservable", span);
+}
+/**
+ * BSB Observable Controller - Unified logging, metrics, and tracing
+ *
+ * This class is responsible for managing all observability in the BSB framework.
+ * It coordinates observable plugins (like OpenTelemetry, Prometheus, etc.) and
+ * routes events from the Observable API to the configured backends.
+ *
+ * If you have a specific way of managing observability, you can extend this class
+ * and use your own class when creating the ServiceBase instance.
+ *
+ * @group Observable
+ * @category Core
+ * @see {@link https://bsbcode.dev/languages/nodejs/types/classes/SBObservable.html | API: SBObservable}
+ *
+ * @example
+ * ```typescript
+ * // Custom observable controller
+ * class MyObservable extends SBObservable {
+ *   // Override methods as needed
+ * }
+ *
+ * // Use custom controller
+ * const serviceBase = new ServiceBase(appId, {
+ *   observableClass: MyObservable
+ * });
+ * ```
+ */
+class SBObservable {
+    observablePlugins = [];
+    observableBus = new node_events_1.EventEmitter();
+    mode = "development";
+    appId;
+    cwd;
+    sbPlugins;
+    observableBackend;
+    _ready = false;
+    /**
+     * Check if observable plugins are ready
+     * @returns true if all plugins have been initialized
+     */
+    get isReady() {
+        return this._ready;
+    }
+    /**
+     * Create an SBObservable instance
+     * @param appId - Application ID
+     * @param mode - Debug mode (development, production, production-debug)
+     * @param cwd - Current working directory
+     * @param sbPlugins - Plugin manager instance
+     */
+    constructor(appId, mode, cwd, sbPlugins) {
+        this.appId = appId;
+        this.mode = mode;
+        this.cwd = cwd;
+        this.sbPlugins = sbPlugins;
+        const observablePluginName = "core-observable";
+        this.observableBackend = new base_1.ObservableBackend(this.mode, appId, observablePluginName, this);
+        // Setup logging events
+        if (this.mode !== "production") {
+            this.observableBus.on("debug", (plugin, trace, message, meta) => {
+                this.triggerEvent("debug", plugin, trace, message, meta);
+            });
+        }
+        this.observableBus.on("info", (plugin, trace, message, meta) => {
+            this.triggerEvent("info", plugin, trace, message, meta);
+        });
+        this.observableBus.on("warn", (plugin, trace, message, meta) => {
+            this.triggerEvent("warn", plugin, trace, message, meta);
+        });
+        this.observableBus.on("error", (plugin, trace, message, meta) => {
+            this.triggerEvent("error", plugin, trace, message, meta);
+        });
+        // Setup metrics events
+        this.setupCounterEvents();
+        this.setupGaugeEvents();
+        this.setupHistogramEvents();
+        this.setupSpanEvents();
+    }
+    setupCounterEvents() {
+        this.observableBus.on("createCounter", async (timestamp, pluginName, name, description, help, labels) => {
+            this.triggerMetricEvent("counter", async (plugin) => {
+                await (0, base_1.SmartFunctionCallAsync)(plugin, plugin.createCounter?.bind(plugin), timestamp, pluginName, name, description, help, labels);
+            });
+        });
+        this.observableBus.on("incrementCounter", async (timestamp, pluginName, name, value, labels) => {
+            this.triggerMetricEvent("counter", async (plugin) => {
+                await (0, base_1.SmartFunctionCallAsync)(plugin, plugin.incrementCounter?.bind(plugin), timestamp, pluginName, name, value, labels);
+            });
+        });
+    }
+    setupGaugeEvents() {
+        this.observableBus.on("createGauge", async (timestamp, pluginName, name, description, help, labels) => {
+            this.triggerMetricEvent("gauge", async (plugin) => {
+                await (0, base_1.SmartFunctionCallAsync)(plugin, plugin.createGauge?.bind(plugin), timestamp, pluginName, name, description, help, labels);
+            });
+        });
+        this.observableBus.on("setGauge", async (timestamp, pluginName, name, value, labels) => {
+            this.triggerMetricEvent("gauge", async (plugin) => {
+                await (0, base_1.SmartFunctionCallAsync)(plugin, plugin.setGauge?.bind(plugin), timestamp, pluginName, name, value, labels);
+            });
+        });
+    }
+    setupHistogramEvents() {
+        this.observableBus.on("createHistogram", async (timestamp, pluginName, name, description, help, boundaries, labels) => {
+            this.triggerMetricEvent("histogram", async (plugin) => {
+                await (0, base_1.SmartFunctionCallAsync)(plugin, plugin.createHistogram?.bind(plugin), timestamp, pluginName, name, description, help, boundaries, labels);
+            });
+        });
+        this.observableBus.on("observeHistogram", async (timestamp, pluginName, name, value, labels) => {
+            this.triggerMetricEvent("histogram", async (plugin) => {
+                await (0, base_1.SmartFunctionCallAsync)(plugin, plugin.observeHistogram?.bind(plugin), timestamp, pluginName, name, value, labels);
+            });
+        });
+    }
+    setupSpanEvents() {
+        this.observableBus.on("spanStart", async (trace, pluginName, spanName, parentSpanId, attributes) => {
+            this.triggerSpanEvent("spanStart", async (plugin) => {
+                await (0, base_1.SmartFunctionCallAsync)(plugin, plugin.spanStart?.bind(plugin), trace, pluginName, spanName, parentSpanId, attributes);
+            });
+        });
+        this.observableBus.on("spanEnd", async (trace, pluginName, attributes) => {
+            this.triggerSpanEvent("spanEnd", async (plugin) => {
+                await (0, base_1.SmartFunctionCallAsync)(plugin, plugin.spanEnd?.bind(plugin), trace, pluginName, attributes);
+            });
+        });
+        this.observableBus.on("spanError", async (trace, pluginName, error, attributes) => {
+            this.triggerSpanEvent("spanError", async (plugin) => {
+                await (0, base_1.SmartFunctionCallAsync)(plugin, plugin.spanError?.bind(plugin), trace, pluginName, error, attributes);
+            });
+        });
+    }
+    triggerEvent(eventType, pluginName, trace, message, meta) {
+        for (const observablePlugin of this.observablePlugins) {
+            if (!this.shouldTriggerForPlugin(eventType, pluginName, observablePlugin)) {
+                continue;
+            }
+            const method = observablePlugin.plugin[eventType];
+            if (method) {
+                (0, base_1.SmartFunctionCallAsync)(observablePlugin.plugin, method.bind(observablePlugin.plugin), trace, pluginName, message, meta);
+            }
+        }
+    }
+    async triggerMetricEvent(eventType, executor) {
+        for (const observablePlugin of this.observablePlugins) {
+            if (!this.shouldTriggerForPlugin(eventType, "", observablePlugin)) {
+                continue;
+            }
+            await executor(observablePlugin.plugin);
+        }
+    }
+    async triggerSpanEvent(eventType, executor) {
+        for (const observablePlugin of this.observablePlugins) {
+            if (!this.shouldTriggerForPlugin(eventType, "", observablePlugin)) {
+                continue;
+            }
+            await executor(observablePlugin.plugin);
+        }
+    }
+    shouldTriggerForPlugin(eventType, pluginName, observablePlugin) {
+        if (observablePlugin.onTypeof === "all") {
+            return true;
+        }
+        if (observablePlugin.on === undefined) {
+            return true;
+        }
+        // Handle array filter (events)
+        if (Array.isArray(observablePlugin.on)) {
+            return observablePlugin.on.includes(eventType);
+        }
+        // Handle object filters
+        const filterValue = observablePlugin.on[eventType];
+        if (filterValue === undefined) {
+            return false;
+        }
+        // eventsState: Record<EventType, boolean>
+        if (typeof filterValue === "boolean") {
+            return filterValue;
+        }
+        // eventsPlugins: Record<EventType, Array<string>>
+        if (Array.isArray(filterValue)) {
+            return filterValue.includes(pluginName);
+        }
+        // eventsDetailed: Record<EventType, { plugins: Array<string>; enabled: boolean }>
+        if (typeof filterValue === "object" && "enabled" in filterValue) {
+            const detailed = filterValue;
+            if (!detailed.enabled) {
+                return false;
+            }
+            if (detailed.plugins.length === 0) {
+                return true;
+            }
+            return detailed.plugins.includes(pluginName);
+        }
+        return false;
+    }
+    determineFilterType(filter) {
+        if (!filter) {
+            return "all";
+        }
+        if (Array.isArray(filter)) {
+            return "events";
+        }
+        const keys = Object.keys(filter);
+        if (keys.length === 0) {
+            return "all";
+        }
+        const firstValue = filter[keys[0]];
+        if (typeof firstValue === "boolean") {
+            return "eventsState";
+        }
+        if (Array.isArray(firstValue)) {
+            return "eventsPlugins";
+        }
+        if (typeof firstValue === "object" && "enabled" in firstValue) {
+            return "eventsDetailed";
+        }
+        return "all";
+    }
+    /**
+     * Setup and load observable plugins from configuration
+     *
+     * Loads configured observable plugins and initializes their filters.
+     * This is called during ServiceBase initialization.
+     *
+     * @param sbConfig - Configuration manager instance
+     */
+    async setupObservablePlugins(sbConfig) {
+        const trace = internalTrace("setupObservablePlugins");
+        this.observableBackend.info(trace, "Setting up observable plugins");
+        const observablePluginsFromConfig = await sbConfig.getObservablePlugins(trace);
+        for (const pluginKey of Object.keys(observablePluginsFromConfig)) {
+            const pluginDef = observablePluginsFromConfig[pluginKey];
+            if (!pluginDef.enabled) {
+                this.observableBackend.info(trace, "Observable plugin {plugin} is disabled", { plugin: pluginKey });
+                continue;
+            }
+            try {
+                const loadResult = await this.sbPlugins.loadPlugin(this.observableBackend, pluginDef.package ?? null, pluginDef.plugin, pluginKey);
+                if (!loadResult || !loadResult.success) {
+                    this.observableBackend.error(trace, "Failed to load observable plugin {plugin}", { plugin: pluginKey });
+                    continue;
+                }
+                const loadedPlugin = loadResult.data;
+                this.observableBackend.info(trace, "Loaded observable plugin {plugin} from {package}", {
+                    plugin: pluginKey,
+                    package: loadedPlugin.packageCwd,
+                });
+                const config = await sbConfig.getPluginConfig(trace, "observable", pluginKey);
+                const observablePlugin = new loadedPlugin.plugin({
+                    appId: this.appId,
+                    mode: this.mode,
+                    pluginName: pluginKey,
+                    cwd: this.cwd,
+                    packageCwd: loadedPlugin.packageCwd,
+                    pluginCwd: loadedPlugin.pluginCwd,
+                    pluginVersion: loadedPlugin.version,
+                    config,
+                });
+                this.observablePlugins.push({
+                    plugin: observablePlugin,
+                    on: pluginDef.filter,
+                    onTypeof: this.determineFilterType(pluginDef.filter),
+                });
+                this.observableBackend.info(trace, "Initialized observable plugin {plugin}", { plugin: pluginKey });
+            }
+            catch (error) {
+                this.observableBackend.error(trace, "Failed to load observable plugin {plugin}: {error}", {
+                    plugin: pluginKey,
+                    error: error.message,
+                });
+                throw error;
+            }
+        }
+        if (this.observablePlugins.length === 0) {
+            this.observableBackend.info(trace, "No observable plugins configured, enabling default console logger");
+            this.observablePlugins.push({
+                plugin: new index_1.Plugin({
+                    appId: this.appId,
+                    mode: this.mode,
+                    pluginName: "observable-default",
+                    cwd: this.cwd,
+                    packageCwd: this.cwd,
+                    pluginCwd: this.cwd,
+                    pluginVersion: "0.0.0",
+                    config: undefined,
+                }),
+                on: undefined,
+                onTypeof: "all",
+            });
+        }
+        this._ready = true;
+        this.observableBackend.info(trace, "Observable plugins setup complete");
+    }
+    /**
+     * Initialize all observable plugins
+     *
+     * Calls the init lifecycle method on all loaded observable plugins.
+     * This is called during ServiceBase initialization.
+     *
+     * @param trace - DTrace for tracking initialization
+     * @param sbConfig - Configuration manager instance
+     */
+    async init(trace, sbConfig) {
+        this.observableBackend.info(trace, "Setting up observable plugins");
+        await this.setupObservablePlugins(sbConfig);
+        this.observableBackend.info(trace, "Initializing observable plugins");
+        for (const observablePlugin of this.observablePlugins) {
+            if (observablePlugin.plugin.init) {
+                await observablePlugin.plugin.init.call(observablePlugin.plugin);
+            }
+        }
+        this.observableBackend.info(trace, "Observable plugins initialized");
+    }
+    /**
+     * Run all observable plugins
+     *
+     * Calls the run lifecycle method on all loaded observable plugins.
+     * This is called during ServiceBase startup.
+     *
+     * @param trace - DTrace for tracking the run phase
+     */
+    async run(trace) {
+        this.observableBackend.info(trace, "Running observable plugins");
+        // If any non-default plugin handles all events, remove the default to avoid duplicate output
+        if (this.observablePlugins.length > 1) {
+            const nonDefault = this.observablePlugins.filter((x) => x.plugin.pluginName !== "observable-default");
+            const hasAllHandler = nonDefault.some((x) => x.onTypeof === "all");
+            if (hasAllHandler) {
+                const defaultPlugin = this.observablePlugins.find((x) => x.plugin.pluginName === "observable-default");
+                if (defaultPlugin) {
+                    if (defaultPlugin.plugin.dispose) {
+                        await (0, base_1.SmartFunctionCallAsync)(defaultPlugin.plugin, defaultPlugin.plugin.dispose);
+                    }
+                    this.observablePlugins = this.observablePlugins.filter((x) => x.plugin.pluginName !== "observable-default");
+                }
+            }
+        }
+        for (const observablePlugin of this.observablePlugins) {
+            if (observablePlugin.plugin.run) {
+                await observablePlugin.plugin.run.call(observablePlugin.plugin);
+            }
+        }
+        this.observableBackend.info(trace, "Observable plugins running");
+    }
+    /**
+     * Dispose all observable plugins
+     *
+     * Calls the dispose lifecycle method on all loaded observable plugins
+     * and clears the plugin list. This is called during ServiceBase shutdown.
+     */
+    async dispose() {
+        for (const observablePlugin of this.observablePlugins) {
+            if (observablePlugin.plugin.dispose) {
+                await (0, base_1.SmartFunctionCallAsync)(observablePlugin.plugin, observablePlugin.plugin.dispose);
+            }
+        }
+        this.observablePlugins = [];
+    }
+    // Logging API (for PluginLogging to use)
+    /**
+     * Emit a debug log event
+     * @param plugin - Plugin name
+     * @param trace - DTrace object
+     * @param message - Log message
+     * @param meta - Log metadata
+     */
+    debug(plugin, trace, message, meta) {
+        this.observableBus.emit("debug", plugin, trace, message, meta);
+    }
+    /**
+     * Emit an info log event
+     * @param plugin - Plugin name
+     * @param trace - DTrace object
+     * @param message - Log message
+     * @param meta - Log metadata
+     */
+    info(plugin, trace, message, meta) {
+        this.observableBus.emit("info", plugin, trace, message, meta);
+    }
+    /**
+     * Emit a warn log event
+     * @param plugin - Plugin name
+     * @param trace - DTrace object
+     * @param message - Log message
+     * @param meta - Log metadata
+     */
+    warn(plugin, trace, message, meta) {
+        this.observableBus.emit("warn", plugin, trace, message, meta);
+    }
+    /**
+     * Emit an error log event
+     * @param plugin - Plugin name
+     * @param trace - DTrace object
+     * @param message - Log message or BSBError
+     * @param meta - Log metadata (optional)
+     */
+    error(plugin, trace, message, meta) {
+        this.observableBus.emit("error", plugin, trace, message, meta);
+    }
+    // Metrics API (for PluginMetrics to use)
+    /**
+     * Emit counter creation event
+     * @param timestamp - Event timestamp
+     * @param pluginName - Plugin name
+     * @param name - Metric name
+     * @param description - Short description
+     * @param help - Detailed help text
+     * @param labels - Optional label names
+     */
+    createCounter(timestamp, pluginName, name, description, help, labels) {
+        this.observableBus.emit("createCounter", timestamp, pluginName, name, description, help, labels);
+    }
+    /**
+     * Emit counter increment event
+     * @param timestamp - Event timestamp
+     * @param pluginName - Plugin name
+     * @param name - Metric name
+     * @param value - Increment value
+     * @param labels - Optional label values
+     */
+    incrementCounter(timestamp, pluginName, name, value, labels) {
+        this.observableBus.emit("incrementCounter", timestamp, pluginName, name, value, labels);
+    }
+    /**
+     * Emit gauge creation event
+     * @param timestamp - Event timestamp
+     * @param pluginName - Plugin name
+     * @param name - Metric name
+     * @param description - Short description
+     * @param help - Detailed help text
+     * @param labels - Optional label names
+     */
+    createGauge(timestamp, pluginName, name, description, help, labels) {
+        this.observableBus.emit("createGauge", timestamp, pluginName, name, description, help, labels);
+    }
+    /**
+     * Emit gauge set event
+     * @param timestamp - Event timestamp
+     * @param pluginName - Plugin name
+     * @param name - Metric name
+     * @param value - New gauge value
+     * @param labels - Optional label values
+     */
+    setGauge(timestamp, pluginName, name, value, labels) {
+        this.observableBus.emit("setGauge", timestamp, pluginName, name, value, labels);
+    }
+    /**
+     * Emit histogram creation event
+     * @param timestamp - Event timestamp
+     * @param pluginName - Plugin name
+     * @param name - Metric name
+     * @param description - Short description
+     * @param help - Detailed help text
+     * @param boundaries - Optional histogram boundaries
+     * @param labels - Optional label names
+     */
+    createHistogram(timestamp, pluginName, name, description, help, boundaries, labels) {
+        this.observableBus.emit("createHistogram", timestamp, pluginName, name, description, help, boundaries, labels);
+    }
+    /**
+     * Emit histogram observation event
+     * @param timestamp - Event timestamp
+     * @param pluginName - Plugin name
+     * @param name - Metric name
+     * @param value - Observed value
+     * @param labels - Optional label values
+     */
+    observeHistogram(timestamp, pluginName, name, value, labels) {
+        this.observableBus.emit("observeHistogram", timestamp, pluginName, name, value, labels);
+    }
+    /**
+     * Emit span start event
+     * @param timestamp - Event timestamp
+     * @param appId - Application ID
+     * @param pluginName - Plugin name
+     * @param traceId - Trace ID
+     * @param parentSpanId - Parent span ID (null for root spans)
+     * @param spanId - This span's ID
+     * @param name - Span name
+     * @param attributes - Optional span attributes
+     */
+    startSpan(timestamp, appId, pluginName, traceId, parentSpanId, spanId, name, attributes) {
+        this.observableBus.emit("spanStart", { t: traceId, s: spanId }, pluginName, name, parentSpanId, attributes);
+    }
+    /**
+     * Emit span end event
+     * @param timestamp - Event timestamp
+     * @param appId - Application ID
+     * @param pluginName - Plugin name
+     * @param traceId - Trace ID
+     * @param spanId - Span ID
+     * @param attributes - Optional final attributes
+     */
+    endSpan(timestamp, appId, pluginName, traceId, spanId, attributes) {
+        this.observableBus.emit("spanEnd", { t: traceId, s: spanId }, pluginName, attributes);
+    }
+    /**
+     * Emit span error event
+     * @param timestamp - Event timestamp
+     * @param appId - Application ID
+     * @param pluginName - Plugin name
+     * @param traceId - Trace ID
+     * @param spanId - Span ID
+     * @param error - Error to record
+     * @param attributes - Optional error attributes
+     */
+    errorSpan(timestamp, appId, pluginName, traceId, spanId, error, attributes) {
+        this.observableBus.emit("spanError", { t: traceId, s: spanId }, pluginName, error, attributes);
+    }
+}
+exports.SBObservable = SBObservable;
+//# sourceMappingURL=observable.js.map

package/lib/serviceBase/observable.js.map

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

package/lib/serviceBase/plugins.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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/>.
+ */
+import { IPluginLogging, LoadedPlugin, PluginType, PluginTypeDefinitionRef, Result } from "../interfaces";
+/**
+ * BSB Plugins Controller
+ *
+ * This class is responsible for loading the plugins in the BSB framework.
+ * If you have a specific way of loading plugins, you can extend this class and then use your own class when creating the ServiceBase instance.
+ *
+ * @group Plugins
+ * @category Core
+ */
+export declare class SBPlugins {
+    /**
+     * @see {@link https://bsbcode.dev/languages/nodejs/types/classes/SBPlugins.html | API: SBPlugins}
+     */
+    protected cwd: string;
+    protected nodeModulesPluginDir: string;
+    protected referencedPluginDir: string | null;
+    protected devMode: boolean;
+    constructor(cwd: string, devMode: boolean);
+    loadPlugin<NamedType extends PluginType, ClassType extends PluginTypeDefinitionRef<NamedType> = PluginTypeDefinitionRef<NamedType>>(log: IPluginLogging, npmPackage: string | null, plugin: string, name: string): Promise<Result<LoadedPlugin<NamedType, ClassType>, Error>>;
+    loadPluginFile<NamedType extends PluginType, ClassType extends PluginTypeDefinitionRef<NamedType>>(pluginPath: string, pluginName: string, packageCwd: string, version: string): Promise<LoadedPlugin<NamedType, ClassType>>;
+}