@aneuhold/core-ts-lib 2.0.10 → 2.1.1

package/lib/index.d.ts

@@ -1,13 +1,15 @@
 import sleep from './helperFunctions/sleep.js';
+import { ILogger } from './interfaces/ILogger.js';
+import { ISpan, ITracer } from './interfaces/ITracer.js';
 import ArrayService from './services/ArrayService.js';
 import DateService from './services/DateService/DateService.js';
+import { DependencyRegistry, DR } from './services/DependencyRegistry.js';
 import DependencyService, { VersionType } from './services/DependencyService.js';
 import FileSystemService from './services/FileSystemService/FileSystemService.js';
 import PackageService from './services/PackageService.js';
 import StringService from './services/StringService.js';
 import ErrorUtils from './utils/ErrorUtils.js';
-import Logger from './utils/Logger.js';
 import TestUtils from './utils/TestUtils.js';
-export { ArrayService, DateService, DependencyService, ErrorUtils, FileSystemService, Logger, PackageService, sleep, StringService, TestUtils };
-export type { VersionType };
+export { ArrayService, DateService, DependencyRegistry, DependencyService, DR, ErrorUtils, FileSystemService, PackageService, sleep, StringService, TestUtils };
+export type { ILogger, ISpan, ITracer, VersionType };
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,4BAA4B,CAAC;AAC/C,OAAO,YAAY,MAAM,4BAA4B,CAAC;AACtD,OAAO,WAAW,MAAM,uCAAuC,CAAC;AAChE,OAAO,iBAAiB,EAAE,EACxB,WAAW,EACZ,MAAM,iCAAiC,CAAC;AACzC,OAAO,iBAAiB,MAAM,mDAAmD,CAAC;AAClF,OAAO,cAAc,MAAM,8BAA8B,CAAC;AAC1D,OAAO,aAAa,MAAM,6BAA6B,CAAC;AACxD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,MAAM,MAAM,mBAAmB,CAAC;AACvC,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAG7C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,KAAK,EACL,aAAa,EACb,SAAS,EACV,CAAC;AAGF,YAAY,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,4BAA4B,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,YAAY,MAAM,4BAA4B,CAAC;AACtD,OAAO,WAAW,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,iBAAiB,EAAE,EACxB,WAAW,EACZ,MAAM,iCAAiC,CAAC;AACzC,OAAO,iBAAiB,MAAM,mDAAmD,CAAC;AAClF,OAAO,cAAc,MAAM,8BAA8B,CAAC;AAC1D,OAAO,aAAa,MAAM,6BAA6B,CAAC;AACxD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAG7C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,EAAE,EACF,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,KAAK,EACL,aAAa,EACb,SAAS,EACV,CAAC;AAGF,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/lib/index.js

@@ -1,13 +1,13 @@
 import sleep from './helperFunctions/sleep.js';
 import ArrayService from './services/ArrayService.js';
 import DateService from './services/DateService/DateService.js';
+import { DependencyRegistry, DR } from './services/DependencyRegistry.js';
 import DependencyService from './services/DependencyService.js';
 import FileSystemService from './services/FileSystemService/FileSystemService.js';
 import PackageService from './services/PackageService.js';
 import StringService from './services/StringService.js';
 import ErrorUtils from './utils/ErrorUtils.js';
-import Logger from './utils/Logger.js';
 import TestUtils from './utils/TestUtils.js';
 // Export all the functions and classes from this library
-export { ArrayService, DateService, DependencyService, ErrorUtils, FileSystemService, Logger, PackageService, sleep, StringService, TestUtils };
+export { ArrayService, DateService, DependencyRegistry, DependencyService, DR, ErrorUtils, FileSystemService, PackageService, sleep, StringService, TestUtils };
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,4BAA4B,CAAC;AAC/C,OAAO,YAAY,MAAM,4BAA4B,CAAC;AACtD,OAAO,WAAW,MAAM,uCAAuC,CAAC;AAChE,OAAO,iBAEN,MAAM,iCAAiC,CAAC;AACzC,OAAO,iBAAiB,MAAM,mDAAmD,CAAC;AAClF,OAAO,cAAc,MAAM,8BAA8B,CAAC;AAC1D,OAAO,aAAa,MAAM,6BAA6B,CAAC;AACxD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,MAAM,MAAM,mBAAmB,CAAC;AACvC,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAE7C,yDAAyD;AACzD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,KAAK,EACL,aAAa,EACb,SAAS,EACV,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,4BAA4B,CAAC;AAG/C,OAAO,YAAY,MAAM,4BAA4B,CAAC;AACtD,OAAO,WAAW,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,iBAEN,MAAM,iCAAiC,CAAC;AACzC,OAAO,iBAAiB,MAAM,mDAAmD,CAAC;AAClF,OAAO,cAAc,MAAM,8BAA8B,CAAC;AAC1D,OAAO,aAAa,MAAM,6BAA6B,CAAC;AACxD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAE7C,yDAAyD;AACzD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,EAAE,EACF,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,KAAK,EACL,aAAa,EACb,SAAS,EACV,CAAC"}

package/lib/index.ts

@@ -1,6 +1,9 @@
 import sleep from './helperFunctions/sleep.js';
+import { ILogger } from './interfaces/ILogger.js';
+import { ISpan, ITracer } from './interfaces/ITracer.js';
 import ArrayService from './services/ArrayService.js';
 import DateService from './services/DateService/DateService.js';
+import { DependencyRegistry, DR } from './services/DependencyRegistry.js';
 import DependencyService, {
   VersionType
 } from './services/DependencyService.js';
@@ -8,17 +11,17 @@ import FileSystemService from './services/FileSystemService/FileSystemService.js
 import PackageService from './services/PackageService.js';
 import StringService from './services/StringService.js';
 import ErrorUtils from './utils/ErrorUtils.js';
-import Logger from './utils/Logger.js';
 import TestUtils from './utils/TestUtils.js';
 
 // Export all the functions and classes from this library
 export {
   ArrayService,
   DateService,
+  DependencyRegistry,
   DependencyService,
+  DR,
   ErrorUtils,
   FileSystemService,
-  Logger,
   PackageService,
   sleep,
   StringService,
@@ -26,4 +29,4 @@ export {
 };
 
 // Export TypeScript types where needed
-export type { VersionType };
+export type { ILogger, ISpan, ITracer, VersionType };

package/lib/interfaces/ILogger.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Interface for a standard logger service.
+ */
+export interface ILogger {
+    /**
+     * Logs informational messages.
+     *
+     * @param msg - The message to log.
+     * @param skipNewline - Optional. If true, does not append a newline.
+     */
+    info(msg: string, skipNewline?: boolean): void;
+    /**
+     * Logs success messages.
+     *
+     * @param msg - The message to log.
+     */
+    success(msg: string): void;
+    /**
+     * Logs failure messages (non-critical).
+     *
+     * @param msg - The message to log.
+     */
+    failure(msg: string): void;
+    /**
+     * Logs error messages (potentially critical).
+     *
+     * @param msg - The message to log.
+     */
+    error(msg: string): void;
+    /**
+     * Gets a logger instance configured for verbose logging.
+     * Implementations should return an ILogger that only logs
+     * when verbose mode is enabled globally.
+     */
+    get verbose(): ILogger;
+}
+/**
+ * A logger implementation that performs no operations.
+ * Useful as a default or in environments where logging is disabled.
+ */
+export declare class NoopLogger implements ILogger {
+    info(): void;
+    success(): void;
+    failure(): void;
+    error(): void;
+    get verbose(): ILogger;
+}
+//# sourceMappingURL=ILogger.d.ts.map

package/lib/interfaces/ILogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.d.ts","sourceRoot":"./src/","sources":["interfaces/ILogger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE/C;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;;;OAIG;IACH,IAAI,OAAO,IAAI,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,UAAW,YAAW,OAAO;IACxC,IAAI,IAAI,IAAI;IACZ,OAAO,IAAI,IAAI;IACf,OAAO,IAAI,IAAI;IACf,KAAK,IAAI,IAAI;IACb,IAAI,OAAO,IAAI,OAAO,CAGrB;CACF"}

package/lib/interfaces/ILogger.js

@@ -0,0 +1,15 @@
+/**
+ * A logger implementation that performs no operations.
+ * Useful as a default or in environments where logging is disabled.
+ */
+export class NoopLogger {
+    info() { }
+    success() { }
+    failure() { }
+    error() { }
+    get verbose() {
+        // Return itself, as it does nothing anyway
+        return this;
+    }
+}
+//# sourceMappingURL=ILogger.js.map

package/lib/interfaces/ILogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.js","sourceRoot":"./src/","sources":["interfaces/ILogger.ts"],"names":[],"mappings":"AAyCA;;;GAGG;AACH,MAAM,OAAO,UAAU;IACrB,IAAI,KAAU,CAAC;IACf,OAAO,KAAU,CAAC;IAClB,OAAO,KAAU,CAAC;IAClB,KAAK,KAAU,CAAC;IAChB,IAAI,OAAO;QACT,2CAA2C;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/interfaces/ILogger.ts

@@ -0,0 +1,55 @@
+/**
+ * Interface for a standard logger service.
+ */
+export interface ILogger {
+  /**
+   * Logs informational messages.
+   *
+   * @param msg - The message to log.
+   * @param skipNewline - Optional. If true, does not append a newline.
+   */
+  info(msg: string, skipNewline?: boolean): void;
+
+  /**
+   * Logs success messages.
+   *
+   * @param msg - The message to log.
+   */
+  success(msg: string): void;
+
+  /**
+   * Logs failure messages (non-critical).
+   *
+   * @param msg - The message to log.
+   */
+  failure(msg: string): void;
+
+  /**
+   * Logs error messages (potentially critical).
+   *
+   * @param msg - The message to log.
+   */
+  error(msg: string): void;
+
+  /**
+   * Gets a logger instance configured for verbose logging.
+   * Implementations should return an ILogger that only logs
+   * when verbose mode is enabled globally.
+   */
+  get verbose(): ILogger;
+}
+
+/**
+ * A logger implementation that performs no operations.
+ * Useful as a default or in environments where logging is disabled.
+ */
+export class NoopLogger implements ILogger {
+  info(): void {}
+  success(): void {}
+  failure(): void {}
+  error(): void {}
+  get verbose(): ILogger {
+    // Return itself, as it does nothing anyway
+    return this;
+  }
+}

package/lib/interfaces/ITracer.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Defines the structure of a span object used for tracing.
+ * This is a minimal interface to avoid dependency on specific tracing libraries.
+ */
+export interface ISpan {
+    /**
+     * Sets the status of the span.
+     *
+     * @param status - An object containing a code and message.
+     *                 Common codes: 1 (OK), 2 (Error/Internal), etc.
+     */
+    setStatus(status: {
+        code: number;
+        message: string;
+    }): void;
+}
+/**
+ * Interface for a tracing service.
+ */
+export interface ITracer {
+    /**
+     * Starts a new span for tracing an operation.
+     *
+     * @param name - The name of the operation/span.
+     * @param callback - The asynchronous function to execute within the span.
+     *                   It receives the span object as an argument.
+     * @returns A promise that resolves with the result of the callback.
+     */
+    startSpan<T>(name: string, callback: (span?: ISpan) => Promise<T>): Promise<T>;
+    /**
+     * Captures an exception for reporting.
+     *
+     * @param exception - The error or exception object.
+     */
+    captureException(exception: unknown): void;
+    /**
+     * Captures a message for reporting.
+     *
+     * @param message - The message string.
+     * @param level - Optional severity level (e.g., 'info', 'warning', 'error').
+     */
+    captureMessage(message: string, level?: string): void;
+    /**
+     * Flushes any buffered trace events.
+     * Important for short-lived environments like serverless functions.
+     *
+     * @param timeout - Optional timeout in milliseconds.
+     * @returns A promise resolving to true if flush finished within timeout.
+     */
+    flush(timeout?: number): Promise<boolean>;
+    /**
+     * Checks if the tracer is enabled and configured.
+     *
+     * @returns True if the tracer is active, false otherwise.
+     */
+    isEnabled(): boolean;
+}
+/**
+ * A tracer implementation that performs no operations.
+ * Useful as a default or in environments where tracing is disabled.
+ */
+export declare class NoopTracer implements ITracer {
+    /**
+     * Executes the callback directly without creating a real span.
+     *
+     * @param _name
+     * @param callback
+     */
+    startSpan<T>(_name: string, callback: (span?: ISpan) => Promise<T>): Promise<T>;
+    /** Does nothing. */
+    captureException(): void;
+    /** Does nothing. */
+    captureMessage(): void;
+    /** Returns true immediately. */
+    flush(): Promise<boolean>;
+    /** Returns false. */
+    isEnabled(): boolean;
+}
+//# sourceMappingURL=ITracer.d.ts.map

package/lib/interfaces/ITracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITracer.d.ts","sourceRoot":"./src/","sources":["interfaces/ITracer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAE5D;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;;OAOG;IACH,SAAS,CAAC,CAAC,EACT,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAE3C;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtD;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1C;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,UAAW,YAAW,OAAO;IACxC;;;;;OAKG;IACG,SAAS,CAAC,CAAC,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC;IAQb,oBAAoB;IACpB,gBAAgB,IAAI,IAAI;IAExB,oBAAoB;IACpB,cAAc,IAAI,IAAI;IAEtB,gCAAgC;IAChC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzB,qBAAqB;IACrB,SAAS,IAAI,OAAO;CAGrB"}

package/lib/interfaces/ITracer.js

@@ -0,0 +1,32 @@
+/**
+ * A tracer implementation that performs no operations.
+ * Useful as a default or in environments where tracing is disabled.
+ */
+export class NoopTracer {
+    /**
+     * Executes the callback directly without creating a real span.
+     *
+     * @param _name
+     * @param callback
+     */
+    async startSpan(_name, callback) {
+        // Provide a dummy span object that does nothing
+        const noopSpan = {
+            setStatus: () => { }
+        };
+        return callback(noopSpan);
+    }
+    /** Does nothing. */
+    captureException() { }
+    /** Does nothing. */
+    captureMessage() { }
+    /** Returns true immediately. */
+    flush() {
+        return Promise.resolve(true);
+    }
+    /** Returns false. */
+    isEnabled() {
+        return false;
+    }
+}
+//# sourceMappingURL=ITracer.js.map

package/lib/interfaces/ITracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITracer.js","sourceRoot":"./src/","sources":["interfaces/ITracer.ts"],"names":[],"mappings":"AAgEA;;;GAGG;AACH,MAAM,OAAO,UAAU;IACrB;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CACb,KAAa,EACb,QAAsC;QAEtC,gDAAgD;QAChD,MAAM,QAAQ,GAAU;YACtB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;SACpB,CAAC;QACF,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,oBAAoB;IACpB,gBAAgB,KAAU,CAAC;IAE3B,oBAAoB;IACpB,cAAc,KAAU,CAAC;IAEzB,gCAAgC;IAChC,KAAK;QACH,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,qBAAqB;IACrB,SAAS;QACP,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/lib/interfaces/ITracer.ts

@@ -0,0 +1,102 @@
+/**
+ * Defines the structure of a span object used for tracing.
+ * This is a minimal interface to avoid dependency on specific tracing libraries.
+ */
+export interface ISpan {
+  /**
+   * Sets the status of the span.
+   *
+   * @param status - An object containing a code and message.
+   *                 Common codes: 1 (OK), 2 (Error/Internal), etc.
+   */
+  setStatus(status: { code: number; message: string }): void;
+  // Add other methods you might need from the span, e.g., recordError, end
+}
+
+/**
+ * Interface for a tracing service.
+ */
+export interface ITracer {
+  /**
+   * Starts a new span for tracing an operation.
+   *
+   * @param name - The name of the operation/span.
+   * @param callback - The asynchronous function to execute within the span.
+   *                   It receives the span object as an argument.
+   * @returns A promise that resolves with the result of the callback.
+   */
+  startSpan<T>(
+    name: string,
+    callback: (span?: ISpan) => Promise<T>
+  ): Promise<T>;
+
+  /**
+   * Captures an exception for reporting.
+   *
+   * @param exception - The error or exception object.
+   */
+  captureException(exception: unknown): void;
+
+  /**
+   * Captures a message for reporting.
+   *
+   * @param message - The message string.
+   * @param level - Optional severity level (e.g., 'info', 'warning', 'error').
+   */
+  captureMessage(message: string, level?: string): void;
+
+  /**
+   * Flushes any buffered trace events.
+   * Important for short-lived environments like serverless functions.
+   *
+   * @param timeout - Optional timeout in milliseconds.
+   * @returns A promise resolving to true if flush finished within timeout.
+   */
+  flush(timeout?: number): Promise<boolean>;
+
+  /**
+   * Checks if the tracer is enabled and configured.
+   *
+   * @returns True if the tracer is active, false otherwise.
+   */
+  isEnabled(): boolean;
+}
+
+/**
+ * A tracer implementation that performs no operations.
+ * Useful as a default or in environments where tracing is disabled.
+ */
+export class NoopTracer implements ITracer {
+  /**
+   * Executes the callback directly without creating a real span.
+   *
+   * @param _name
+   * @param callback
+   */
+  async startSpan<T>(
+    _name: string,
+    callback: (span?: ISpan) => Promise<T>
+  ): Promise<T> {
+    // Provide a dummy span object that does nothing
+    const noopSpan: ISpan = {
+      setStatus: () => {}
+    };
+    return callback(noopSpan);
+  }
+
+  /** Does nothing. */
+  captureException(): void {}
+
+  /** Does nothing. */
+  captureMessage(): void {}
+
+  /** Returns true immediately. */
+  flush(): Promise<boolean> {
+    return Promise.resolve(true);
+  }
+
+  /** Returns false. */
+  isEnabled(): boolean {
+    return false;
+  }
+}

package/lib/services/DependencyRegistry.d.ts

@@ -0,0 +1,43 @@
+import { ILogger } from '../interfaces/ILogger.js';
+import { ITracer } from '../interfaces/ITracer.js';
+/**
+ * A simple static registry for managing singleton service instances like loggers and tracers.
+ * Provides a central point for accessing shared services throughout an application.
+ */
+export declare class DependencyRegistry {
+    private static loggerInstance;
+    private static tracerInstance;
+    /**
+     * Registers a logger implementation, overwriting the existing one.
+     * Should typically be called once at application startup if a custom logger is needed.
+     *
+     * @param instance - The ILogger instance to register.
+     */
+    static registerLogger(instance: ILogger): void;
+    /**
+     * Gets the currently registered logger instance.
+     * Defaults to ConsoleLogger if no other logger has been registered.
+     *
+     * @returns The registered ILogger instance.
+     */
+    static get logger(): ILogger;
+    /**
+     * Registers a tracer implementation, overwriting the existing one.
+     * Should typically be called once at application startup if tracing is needed.
+     *
+     * @param instance - The ITracer instance to register.
+     */
+    static registerTracer(instance: ITracer): void;
+    /**
+     * Gets the currently registered tracer instance.
+     * Defaults to NoopTracer if no other tracer has been registered.
+     *
+     * @returns The registered ITracer instance.
+     */
+    static get tracer(): ITracer;
+}
+/**
+ * Alias for DependencyRegistry for more succinct usage.
+ */
+export declare const DR: typeof DependencyRegistry;
+//# sourceMappingURL=DependencyRegistry.d.ts.map

package/lib/services/DependencyRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyRegistry.d.ts","sourceRoot":"./src/","sources":["services/DependencyRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAc,MAAM,0BAA0B,CAAC;AAG/D;;;GAGG;AACH,qBAAa,kBAAkB;IAE7B,OAAO,CAAC,MAAM,CAAC,cAAc,CAAgC;IAC7D,OAAO,CAAC,MAAM,CAAC,cAAc,CAA6B;IAE1D;;;;;OAKG;WACW,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIrD;;;;;OAKG;IACH,WAAkB,MAAM,IAAI,OAAO,CAElC;IAED;;;;;OAKG;WACW,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIrD;;;;;OAKG;IACH,WAAkB,MAAM,IAAI,OAAO,CAElC;CACF;AAED;;GAEG;AACH,eAAO,MAAM,EAAE,2BAAqB,CAAC"}

package/lib/services/DependencyRegistry.js

@@ -0,0 +1,52 @@
+import { NoopTracer } from '../interfaces/ITracer.js';
+import ConsoleLogger from '../utils/ConsoleLogger.js';
+/**
+ * A simple static registry for managing singleton service instances like loggers and tracers.
+ * Provides a central point for accessing shared services throughout an application.
+ */
+export class DependencyRegistry {
+    // Initialize with concrete defaults
+    static loggerInstance = new ConsoleLogger();
+    static tracerInstance = new NoopTracer();
+    /**
+     * Registers a logger implementation, overwriting the existing one.
+     * Should typically be called once at application startup if a custom logger is needed.
+     *
+     * @param instance - The ILogger instance to register.
+     */
+    static registerLogger(instance) {
+        this.loggerInstance = instance;
+    }
+    /**
+     * Gets the currently registered logger instance.
+     * Defaults to ConsoleLogger if no other logger has been registered.
+     *
+     * @returns The registered ILogger instance.
+     */
+    static get logger() {
+        return this.loggerInstance;
+    }
+    /**
+     * Registers a tracer implementation, overwriting the existing one.
+     * Should typically be called once at application startup if tracing is needed.
+     *
+     * @param instance - The ITracer instance to register.
+     */
+    static registerTracer(instance) {
+        this.tracerInstance = instance;
+    }
+    /**
+     * Gets the currently registered tracer instance.
+     * Defaults to NoopTracer if no other tracer has been registered.
+     *
+     * @returns The registered ITracer instance.
+     */
+    static get tracer() {
+        return this.tracerInstance;
+    }
+}
+/**
+ * Alias for DependencyRegistry for more succinct usage.
+ */
+export const DR = DependencyRegistry;
+//# sourceMappingURL=DependencyRegistry.js.map

package/lib/services/DependencyRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyRegistry.js","sourceRoot":"./src/","sources":["services/DependencyRegistry.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,aAAa,MAAM,2BAA2B,CAAC;AAEtD;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAC7B,oCAAoC;IAC5B,MAAM,CAAC,cAAc,GAAY,IAAI,aAAa,EAAE,CAAC;IACrD,MAAM,CAAC,cAAc,GAAY,IAAI,UAAU,EAAE,CAAC;IAE1D;;;;;OAKG;IACI,MAAM,CAAC,cAAc,CAAC,QAAiB;QAC5C,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACI,MAAM,KAAK,MAAM;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,cAAc,CAAC,QAAiB;QAC5C,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACI,MAAM,KAAK,MAAM;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;;AAGH;;GAEG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG,kBAAkB,CAAC"}

package/lib/services/DependencyRegistry.ts

@@ -0,0 +1,58 @@
+import { ILogger } from '../interfaces/ILogger.js';
+import { ITracer, NoopTracer } from '../interfaces/ITracer.js';
+import ConsoleLogger from '../utils/ConsoleLogger.js';
+
+/**
+ * A simple static registry for managing singleton service instances like loggers and tracers.
+ * Provides a central point for accessing shared services throughout an application.
+ */
+export class DependencyRegistry {
+  // Initialize with concrete defaults
+  private static loggerInstance: ILogger = new ConsoleLogger();
+  private static tracerInstance: ITracer = new NoopTracer();
+
+  /**
+   * Registers a logger implementation, overwriting the existing one.
+   * Should typically be called once at application startup if a custom logger is needed.
+   *
+   * @param instance - The ILogger instance to register.
+   */
+  public static registerLogger(instance: ILogger): void {
+    this.loggerInstance = instance;
+  }
+
+  /**
+   * Gets the currently registered logger instance.
+   * Defaults to ConsoleLogger if no other logger has been registered.
+   *
+   * @returns The registered ILogger instance.
+   */
+  public static get logger(): ILogger {
+    return this.loggerInstance;
+  }
+
+  /**
+   * Registers a tracer implementation, overwriting the existing one.
+   * Should typically be called once at application startup if tracing is needed.
+   *
+   * @param instance - The ITracer instance to register.
+   */
+  public static registerTracer(instance: ITracer): void {
+    this.tracerInstance = instance;
+  }
+
+  /**
+   * Gets the currently registered tracer instance.
+   * Defaults to NoopTracer if no other tracer has been registered.
+   *
+   * @returns The registered ITracer instance.
+   */
+  public static get tracer(): ITracer {
+    return this.tracerInstance;
+  }
+}
+
+/**
+ * Alias for DependencyRegistry for more succinct usage.
+ */
+export const DR = DependencyRegistry;

package/lib/services/DependencyService.js

@@ -1,7 +1,7 @@
 import { access, readFile, writeFile } from 'fs/promises';
 import path from 'path';
 import ErrorUtils from '../utils/ErrorUtils.js';
-import Logger from '../utils/Logger.js';
+import { DR } from './DependencyRegistry.js';
 import FileSystemService from './FileSystemService/FileSystemService.js';
 /**
  * Standard Semantic Versioning bump types.
@@ -91,7 +91,7 @@ export default class DependencyService {
                 await access(filePath);
             }
             catch {
-                Logger.info(`No ${path.basename(filePath)} file found in the current directory.`);
+                DR.logger.info(`No ${path.basename(filePath)} file found in the current directory.`);
                 return;
             }
             try {
@@ -100,11 +100,11 @@ export default class DependencyService {
                 const newVersion = bump(oldVersion);
                 fileData.version = newVersion;
                 await writeFile(filePath, JSON.stringify(fileData, null, 2));
-                Logger.info(`Bumped ${path.basename(filePath)} from ${oldVersion} to ${newVersion}`);
+                DR.logger.info(`Bumped ${path.basename(filePath)} from ${oldVersion} to ${newVersion}`);
             }
             catch (error) {
                 const errorString = ErrorUtils.getErrorString(error);
-                Logger.error(`Failed to update ${path.basename(filePath)}: ${errorString}`);
+                DR.logger.error(`Failed to update ${path.basename(filePath)}: ${errorString}`);
             }
         };
         const rootDir = process.cwd();

package/lib/services/DependencyService.js.map

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