@bsb/base 9.0.0

package/lib/base/BSBService.d.ts

@@ -0,0 +1,277 @@
+/**
+ * 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 { DTrace, Trace, BSBEventSchemas, Observable, EventSchemaExport, ServiceClientEventSchemas } from "../interfaces";
+import { SBEvents, SBObservable } from "../serviceBase";
+import { BaseWithObservableAndConfig, BaseWithObservableAndConfigConfig } from "./base";
+import { BSBServiceClient } from "./BSBServiceClient";
+import { BSBReferencePluginConfigDefinition, BSBReferencePluginConfigType } from "./PluginConfig";
+import { PluginEvents } from "./PluginEvents";
+import { z } from "zod";
+/**
+ * @hidden
+ */
+export interface BSBServiceConstructor<ReferencedConfig extends BSBReferencePluginConfigType = any, TEventSchemas extends BSBEventSchemas = BSBEventSchemas> extends BaseWithObservableAndConfigConfig<ReferencedConfig extends null ? null : BSBReferencePluginConfigDefinition<ReferencedConfig> & any> {
+    sbEvents: SBEvents;
+    sbObservable: SBObservable;
+    eventSchemas?: TEventSchemas;
+}
+/**
+ * @hidden
+ */
+export interface BSBServiceClientDefinition {
+    name: string;
+    initBeforePlugins?: Array<string>;
+    initAfterPlugins?: Array<string>;
+    runBeforePlugins?: Array<string>;
+    runAfterPlugins?: Array<string>;
+}
+/**
+ * @group Services
+ * @category Plugins
+ */
+/**
+ * Base class for implementing a service plugin.
+ *
+ * v9 Breaking Change: PLUGIN_CLIENT is now auto-generated from Config.metadata.
+ * You must provide a static Config property pointing to your Config class.
+ *
+ * Lifecycle:
+ *  - constructor(config)
+ *  - init(trace): async initialization and event registration
+ *  - run(trace): start processing
+ *  - dispose(): cleanup resources
+  *
+  * @see {@link https://bsbcode.dev/languages/nodejs/types/classes/BSBService.html | API: BSBService}
+  *
+  * @example
+  * ```typescript
+  * export const Config = createConfigSchema(
+  *   { name: 'service-demo', description: 'Demo Service' },
+  *   ConfigSchema
+  * );
+  *
+  * export class Plugin extends BSBService<typeof Config, typeof EventSchemas> {
+  *   static Config = Config; // Required for auto-generation
+  *   // PLUGIN_CLIENT is auto-generated from Config.metadata
+  * }
+  * ```
+ */
+export declare abstract class BSBService<ReferencedConfig extends BSBReferencePluginConfigType = any, TEventSchemas extends BSBEventSchemas = BSBEventSchemas> extends BaseWithObservableAndConfig<ReferencedConfig extends null ? null : BSBReferencePluginConfigDefinition<ReferencedConfig> & any> {
+    /**
+     * Static reference to the Config class created with createConfigSchema().
+     * Required for auto-generating PLUGIN_CLIENT from metadata.
+     *
+     * v9: This must be set on your plugin class for PLUGIN_CLIENT auto-generation to work.
+     */
+    static Config: any;
+    /**
+     * Static reference to EventSchemas created with createEventSchemas().
+     * Required for schema export functionality.
+     *
+     * v9: Set this on your plugin class to enable schema export.
+     */
+    static EventSchemas: BSBEventSchemas;
+    /**
+     * Auto-generated from Config.metadata.
+     * Do not set this manually - it will be ignored and replaced with auto-generated value.
+     *
+     * v9 Breaking Change: This is now a getter that derives from Config.metadata.
+     * If you have a manual PLUGIN_CLIENT property, remove it and set static Config instead.
+     */
+    static get PLUGIN_CLIENT(): BSBServiceClientDefinition;
+    /**
+     * Export event schemas to JSON format for cross-language client generation.
+     *
+     * v9: Call this static method to generate JSON schemas for your plugin's events.
+     * The generated JSON can be consumed by code generators in other languages
+     * to create type-safe clients.
+     *
+     * @returns EventSchemaExport object with plugin metadata and event definitions
+     *
+     * @example
+     * ```typescript
+     * // In your plugin class:
+     * export class Plugin extends BSBService<typeof Config, typeof EventSchemas> {
+     *   static Config = Config;
+     *   static EventSchemas = EventSchemas;
+     * }
+     *
+     * // Export schemas (typically in build script):
+     * const schemas = Plugin.exportSchemas();
+     * fs.writeFileSync('schemas.json', JSON.stringify(schemas, null, 2));
+     * ```
+     */
+    static exportSchemas(): EventSchemaExport;
+    abstract readonly initBeforePlugins?: Array<string>;
+    abstract readonly initAfterPlugins?: Array<string>;
+    abstract readonly runBeforePlugins?: Array<string>;
+    abstract readonly runAfterPlugins?: Array<string>;
+    /** Schema-first event API for this plugin with automatic validation */
+    readonly events: PluginEvents<TEventSchemas>;
+    /**
+     * @hidden
+     */
+    _clients: Array<BSBServiceClient<any>>;
+    /**
+     * @hidden
+     */
+    private _resourceContext;
+    constructor(config: BSBServiceConstructor<ReferencedConfig, TEventSchemas>);
+    /**
+     * Create an Observable from a DTrace with plugin's resource context
+     *
+     * This method wraps a DTrace object in an Observable that provides:
+     * - Automatic trace context for logging
+     * - Resource context (service name, version, region, etc.)
+     * - Immutable attribute propagation
+     * - Child span creation
+     *
+     * @param trace - DTrace object
+     * @param attributes - Optional initial attributes
+     * @param span - Optional Trace/Span object for lifecycle management (enables end() to work)
+     * @returns Observable wrapping the trace
+     *
+     * @example
+     * ```typescript
+     * // Create observable from DTrace
+     * const obs = this.createObservable(trace, { "user.id": "123" });
+     * obs.log.info("Processing request");
+     *
+     * // Create observable from Trace with span lifecycle
+     * const trace = this.__internalObservable.createTrace("http.request");
+     * const obs = this.createObservable(trace.trace, {}, trace);
+     * // ... do work ...
+     * obs.end(); // Properly ends the span
+     * ```
+     *
+     * @see {@link https://bsbcode.dev/languages/nodejs/types/classes/BSBService.html#createObservable | API: BSBService.createObservable}
+     */
+    protected createObservable(trace: DTrace, attributes?: Record<string, string | number | boolean>, span?: Trace): Observable;
+    /**
+     * Create a new trace for distributed tracing
+     *
+     * Creates a new root trace with the given name and attributes. This is useful
+     * for creating new traces in contexts like HTTP handlers where you want to start
+     * a new trace for each request.
+     *
+     * @param name - Name for the trace (e.g., "http.request", "background.job")
+     * @param attributes - Optional initial attributes
+     * @returns Observable with a new trace and span that can be ended
+     *
+     * @example
+     * ```typescript
+     * // In an HTTP handler
+     * async handleRequest(request: Request) {
+     *   const obs = this.createTrace("http.request", {
+     *     "http.method": request.method,
+     *     "http.url": request.url
+     *   });
+     *
+     *   try {
+     *     await this.processRequest(obs, request);
+     *     obs.end({ "http.status": 200 });
+     *   } catch (error) {
+     *     obs.error(error);
+     *     obs.end({ "http.status": 500 });
+     *   }
+     * }
+     * ```
+     *
+     * @see {@link https://bsbcode.dev/languages/nodejs/types/classes/BSBService.html#createTrace | API: BSBService.createTrace}
+     */
+    createTrace(name: string, attributes?: Record<string, string | number | boolean>): Observable;
+    /**
+     * Create a self-client for calling this service's own events.
+     *
+     * Use this when you need to call your own event handlers from within the service
+     * (e.g., HTTP handler calling the service's event-based API). This makes self-invocation
+     * explicit in the code and avoids confusion about event flow.
+     *
+     * Call this method in the constructor and store the result if you need self-invocation.
+     * Only create it if needed to minimize startup overhead.
+     *
+     * The self-client uses the runtime mapped plugin name from the instantiated plugin,
+     * avoiding dependency on compile-time metadata or config. It's registered in the
+     * _clients array and handled normally by the BSB lifecycle.
+     *
+     * @returns Self-client with events property for calling own events
+     *
+     * @example
+     * ```typescript
+     * export class Plugin extends BSBService<typeof Config, typeof EventSchemas> {
+     *   private self;
+     *
+     *   constructor(config: BSBServiceConstructor<typeof Config, typeof EventSchemas>) {
+     *     super({ ...config, eventSchemas: EventSchemas });
+     *
+     *     // Create self-client for HTTP handler to call own events
+     *     this.self = this.createSelf();
+     *   }
+     *
+     *   async handleHttpRequest(obs: Observable, body: any) {
+     *     // Explicitly call own event handler
+     *     const result = await this.self.events.emitEventAndReturn('todo.create', obs, body);
+     *     return { status: 201, data: result };
+     *   }
+     * }
+     * ```
+     */
+    protected createSelf(): BSBSelfServiceClient<this, TEventSchemas>;
+}
+/**
+ * @hidden
+ * Internal self-service client for calling a service's own events.
+ * Created by BSBService.createSelf() method.
+ */
+declare class BSBSelfServiceClient<Service extends BSBService<any, TEventSchemas>, TEventSchemas extends BSBEventSchemas = any> extends BSBServiceClient<Service> {
+    readonly pluginName: string;
+    readonly initBeforePlugins?: Array<string>;
+    readonly initAfterPlugins?: Array<string>;
+    readonly runBeforePlugins?: Array<string>;
+    readonly runAfterPlugins?: Array<string>;
+    events: PluginEvents<ServiceClientEventSchemas<TEventSchemas>>;
+    constructor(context: Service);
+    dispose?(): void;
+    init?(obs: Observable): Promise<void>;
+    run?(obs: Observable): Promise<void>;
+}
+/**
+ * @hidden
+ * DO NOT REFERENCE/USE THIS CLASS - IT IS AN INTERNALLY REFERENCED CLASS
+ */
+export declare class BSBServiceRef extends BSBService<any, BSBEventSchemas> {
+    static Config: import("./PluginConfig").BSBPluginConfigClass<z.ZodNull>;
+    initBeforePlugins?: string[] | undefined;
+    initAfterPlugins?: string[] | undefined;
+    runBeforePlugins?: string[] | undefined;
+    runAfterPlugins?: string[] | undefined;
+    dispose?(): void;
+    init?(obs: Observable): void | Promise<void>;
+    run?(obs: Observable): void | Promise<void>;
+    constructor(config: BSBServiceConstructor<null, BSBEventSchemas>);
+}
+export {};

package/lib/base/BSBService.js

@@ -0,0 +1,366 @@
+"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.BSBServiceRef = exports.BSBService = void 0;
+/* eslint-disable @typescript-eslint/no-unused-vars */
+const interfaces_1 = require("../interfaces");
+const base_1 = require("./base");
+const BSBServiceClient_1 = require("./BSBServiceClient");
+const PluginConfig_1 = require("./PluginConfig");
+const PluginEvents_1 = require("./PluginEvents");
+const ResourceContext_1 = require("./ResourceContext");
+const PluginObservable_1 = require("./PluginObservable");
+const zod_1 = require("zod");
+/**
+ * @group Services
+ * @category Plugins
+ */
+/**
+ * Base class for implementing a service plugin.
+ *
+ * v9 Breaking Change: PLUGIN_CLIENT is now auto-generated from Config.metadata.
+ * You must provide a static Config property pointing to your Config class.
+ *
+ * Lifecycle:
+ *  - constructor(config)
+ *  - init(trace): async initialization and event registration
+ *  - run(trace): start processing
+ *  - dispose(): cleanup resources
+  *
+  * @see {@link https://bsbcode.dev/languages/nodejs/types/classes/BSBService.html | API: BSBService}
+  *
+  * @example
+  * ```typescript
+  * export const Config = createConfigSchema(
+  *   { name: 'service-demo', description: 'Demo Service' },
+  *   ConfigSchema
+  * );
+  *
+  * export class Plugin extends BSBService<typeof Config, typeof EventSchemas> {
+  *   static Config = Config; // Required for auto-generation
+  *   // PLUGIN_CLIENT is auto-generated from Config.metadata
+  * }
+  * ```
+ */
+class BSBService extends base_1.BaseWithObservableAndConfig {
+    /**
+     * Static reference to the Config class created with createConfigSchema().
+     * Required for auto-generating PLUGIN_CLIENT from metadata.
+     *
+     * v9: This must be set on your plugin class for PLUGIN_CLIENT auto-generation to work.
+     */
+    static Config;
+    /**
+     * Static reference to EventSchemas created with createEventSchemas().
+     * Required for schema export functionality.
+     *
+     * v9: Set this on your plugin class to enable schema export.
+     */
+    static EventSchemas;
+    /**
+     * Auto-generated from Config.metadata.
+     * Do not set this manually - it will be ignored and replaced with auto-generated value.
+     *
+     * v9 Breaking Change: This is now a getter that derives from Config.metadata.
+     * If you have a manual PLUGIN_CLIENT property, remove it and set static Config instead.
+     */
+    static get PLUGIN_CLIENT() {
+        // Check if Config is set
+        if (!this.Config) {
+            throw new Error(`[BSB v9] PLUGIN_CLIENT auto-generation requires a static Config property.\n` +
+                `Add this to your plugin class:\n` +
+                `  static Config = Config;\n` +
+                `\n` +
+                `See migration guide: https://bsbcode.dev/migration/v9-breaking-changes`);
+        }
+        const ConfigClass = this.Config;
+        // Check if using old v8 Config class pattern (no metadata)
+        if (!ConfigClass.metadata) {
+            throw new Error(`[BSB v9] Config class must be created with createConfigSchema() helper.\n` +
+                `Old v8 pattern (extending BSBPluginConfig directly) is not supported.\n` +
+                `\n` +
+                `Migration:\n` +
+                `  // OLD v8:\n` +
+                `  export class Config extends BSBPluginConfig<typeof ConfigSchema> {\n` +
+                `    validationSchema = ConfigSchema;\n` +
+                `  }\n` +
+                `\n` +
+                `  // NEW v9:\n` +
+                `  export const Config = createConfigSchema(\n` +
+                `    { name: 'plugin-name', description: 'Description' },\n` +
+                `    ConfigSchema\n` +
+                `  );\n` +
+                `\n` +
+                `See migration guide: https://bsbcode.dev/migration/v9-breaking-changes`);
+        }
+        const meta = ConfigClass.metadata;
+        // Return auto-generated PLUGIN_CLIENT from metadata
+        return {
+            name: meta.name,
+            initBeforePlugins: meta.initBeforePlugins,
+            initAfterPlugins: meta.initAfterPlugins,
+            runBeforePlugins: meta.runBeforePlugins,
+            runAfterPlugins: meta.runAfterPlugins,
+        };
+    }
+    /**
+     * Export event schemas to JSON format for cross-language client generation.
+     *
+     * v9: Call this static method to generate JSON schemas for your plugin's events.
+     * The generated JSON can be consumed by code generators in other languages
+     * to create type-safe clients.
+     *
+     * @returns EventSchemaExport object with plugin metadata and event definitions
+     *
+     * @example
+     * ```typescript
+     * // In your plugin class:
+     * export class Plugin extends BSBService<typeof Config, typeof EventSchemas> {
+     *   static Config = Config;
+     *   static EventSchemas = EventSchemas;
+     * }
+     *
+     * // Export schemas (typically in build script):
+     * const schemas = Plugin.exportSchemas();
+     * fs.writeFileSync('schemas.json', JSON.stringify(schemas, null, 2));
+     * ```
+     */
+    static exportSchemas() {
+        // Check if Config is set
+        if (!this.Config) {
+            throw new Error(`[BSB v9] Schema export requires a static Config property.\n` +
+                `Add this to your plugin class:\n` +
+                `  static Config = Config;\n`);
+        }
+        // Check if EventSchemas is set
+        if (!this.EventSchemas) {
+            throw new Error(`[BSB v9] Schema export requires a static EventSchemas property.\n` +
+                `Add this to your plugin class:\n` +
+                `  static EventSchemas = EventSchemas;\n`);
+        }
+        const ConfigClass = this.Config;
+        const eventSchemas = this.EventSchemas;
+        if (!ConfigClass.metadata) {
+            throw new Error(`[BSB v9] Config class must be created with createConfigSchema() helper.`);
+        }
+        const meta = ConfigClass.metadata;
+        return (0, interfaces_1.exportEventSchemas)(meta.name, meta.version || '1.0.0', eventSchemas);
+    }
+    /** Schema-first event API for this plugin with automatic validation */
+    events;
+    /**
+     * @hidden
+     */
+    _clients = [];
+    /**
+     * @hidden
+     */
+    _resourceContext;
+    constructor(config) {
+        super(config);
+        // Observable backend initialized
+        this.events = new PluginEvents_1.PluginEvents(config.mode, config.sbEvents, this, config.eventSchemas || {}, this.__internalObservable);
+        // Build resource context at construction time
+        this._resourceContext = ResourceContext_1.ResourceContextBuilder.build({
+            appId: config.appId,
+            mode: config.mode,
+            pluginName: config.pluginName,
+            cwd: config.cwd,
+            packageCwd: config.packageCwd,
+            pluginCwd: config.pluginCwd,
+            pluginVersion: config.pluginVersion || 'unknown'
+        }, config.region);
+    }
+    /**
+     * Create an Observable from a DTrace with plugin's resource context
+     *
+     * This method wraps a DTrace object in an Observable that provides:
+     * - Automatic trace context for logging
+     * - Resource context (service name, version, region, etc.)
+     * - Immutable attribute propagation
+     * - Child span creation
+     *
+     * @param trace - DTrace object
+     * @param attributes - Optional initial attributes
+     * @param span - Optional Trace/Span object for lifecycle management (enables end() to work)
+     * @returns Observable wrapping the trace
+     *
+     * @example
+     * ```typescript
+     * // Create observable from DTrace
+     * const obs = this.createObservable(trace, { "user.id": "123" });
+     * obs.log.info("Processing request");
+     *
+     * // Create observable from Trace with span lifecycle
+     * const trace = this.__internalObservable.createTrace("http.request");
+     * const obs = this.createObservable(trace.trace, {}, trace);
+     * // ... do work ...
+     * obs.end(); // Properly ends the span
+     * ```
+     *
+     * @see {@link https://bsbcode.dev/languages/nodejs/types/classes/BSBService.html#createObservable | API: BSBService.createObservable}
+     */
+    createObservable(trace, attributes, span) {
+        return new PluginObservable_1.PluginObservable(trace, this._resourceContext, this.__internalObservable, attributes, span);
+    }
+    /**
+     * Create a new trace for distributed tracing
+     *
+     * Creates a new root trace with the given name and attributes. This is useful
+     * for creating new traces in contexts like HTTP handlers where you want to start
+     * a new trace for each request.
+     *
+     * @param name - Name for the trace (e.g., "http.request", "background.job")
+     * @param attributes - Optional initial attributes
+     * @returns Observable with a new trace and span that can be ended
+     *
+     * @example
+     * ```typescript
+     * // In an HTTP handler
+     * async handleRequest(request: Request) {
+     *   const obs = this.createTrace("http.request", {
+     *     "http.method": request.method,
+     *     "http.url": request.url
+     *   });
+     *
+     *   try {
+     *     await this.processRequest(obs, request);
+     *     obs.end({ "http.status": 200 });
+     *   } catch (error) {
+     *     obs.error(error);
+     *     obs.end({ "http.status": 500 });
+     *   }
+     * }
+     * ```
+     *
+     * @see {@link https://bsbcode.dev/languages/nodejs/types/classes/BSBService.html#createTrace | API: BSBService.createTrace}
+     */
+    createTrace(name, attributes) {
+        const trace = this.__internalObservable.createTrace(name, attributes ?? {});
+        return this.createObservable(trace.trace, attributes ?? {}, trace);
+    }
+    /**
+     * Create a self-client for calling this service's own events.
+     *
+     * Use this when you need to call your own event handlers from within the service
+     * (e.g., HTTP handler calling the service's event-based API). This makes self-invocation
+     * explicit in the code and avoids confusion about event flow.
+     *
+     * Call this method in the constructor and store the result if you need self-invocation.
+     * Only create it if needed to minimize startup overhead.
+     *
+     * The self-client uses the runtime mapped plugin name from the instantiated plugin,
+     * avoiding dependency on compile-time metadata or config. It's registered in the
+     * _clients array and handled normally by the BSB lifecycle.
+     *
+     * @returns Self-client with events property for calling own events
+     *
+     * @example
+     * ```typescript
+     * export class Plugin extends BSBService<typeof Config, typeof EventSchemas> {
+     *   private self;
+     *
+     *   constructor(config: BSBServiceConstructor<typeof Config, typeof EventSchemas>) {
+     *     super({ ...config, eventSchemas: EventSchemas });
+     *
+     *     // Create self-client for HTTP handler to call own events
+     *     this.self = this.createSelf();
+     *   }
+     *
+     *   async handleHttpRequest(obs: Observable, body: any) {
+     *     // Explicitly call own event handler
+     *     const result = await this.self.events.emitEventAndReturn('todo.create', obs, body);
+     *     return { status: 201, data: result };
+     *   }
+     * }
+     * ```
+     */
+    createSelf() {
+        const selfClient = new BSBSelfServiceClient(this);
+        this._clients.push(selfClient);
+        return selfClient;
+    }
+}
+exports.BSBService = BSBService;
+/**
+ * @hidden
+ * Internal self-service client for calling a service's own events.
+ * Created by BSBService.createSelf() method.
+ */
+class BSBSelfServiceClient extends BSBServiceClient_1.BSBServiceClient {
+    pluginName;
+    initBeforePlugins;
+    initAfterPlugins;
+    runBeforePlugins;
+    runAfterPlugins;
+    constructor(context) {
+        super(context);
+        // Use runtime mapped plugin name from the instantiated plugin
+        this.pluginName = context.pluginName;
+        // No dependencies for self-client (same as parent service)
+        this.initBeforePlugins = undefined;
+        this.initAfterPlugins = undefined;
+        this.runBeforePlugins = undefined;
+        this.runAfterPlugins = undefined;
+        // Share the same events instance as the parent service
+        this.events = context.events;
+    }
+    // Self-client has no lifecycle of its own - it just shares the parent service's events
+    dispose() {
+        // No-op: self-client shares parent's lifecycle
+    }
+    init(obs) {
+        // No-op: self-client shares parent's lifecycle
+        return Promise.resolve();
+    }
+    run(obs) {
+        // No-op: self-client shares parent's lifecycle
+        return Promise.resolve();
+    }
+}
+// Dummy Config for internal reference class
+const BSBServiceRefConfig = (0, PluginConfig_1.createConfigSchema)({
+    name: "BSBServiceRef",
+    description: "Internal reference class",
+}, zod_1.z.null());
+/**
+ * @hidden
+ * DO NOT REFERENCE/USE THIS CLASS - IT IS AN INTERNALLY REFERENCED CLASS
+ */
+class BSBServiceRef extends BSBService {
+    static Config = BSBServiceRefConfig;
+    initBeforePlugins;
+    initAfterPlugins;
+    runBeforePlugins;
+    runAfterPlugins;
+    constructor(config) {
+        super(config);
+    }
+}
+exports.BSBServiceRef = BSBServiceRef;
+//# sourceMappingURL=BSBService.js.map

package/lib/base/BSBService.js.map

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