arvo-core 2.2.1 → 2.2.2

package/dist/OpenTelemetry/index.d.ts

@@ -9,12 +9,51 @@ export declare class ArvoOpenTelemetry {
     private static instance;
     private constructor();
     /**
-     * Gets the instance of ArvoOpenTelemetry
-     * @returns {ArvoOpenTelemetry} The singleton instance
+     * Gets or creates the singleton instance of ArvoOpenTelemetry.
+     * This method ensures only one instance of ArvoOpenTelemetry exists throughout the application.
+     *
+     * @param {Object} [config] - Optional configuration object for initializing the instance
+     * @param {Tracer} [config.tracer] - Optional custom OpenTelemetry tracer instance.
+     *                                   If not provided, defaults to a tracer with name 'arvo-instrumentation'
+     *
+     * @returns {ArvoOpenTelemetry} The singleton instance of ArvoOpenTelemetry
+     *
+     * @example
+     * // Get instance with default tracer
+     * const telemetry = ArvoOpenTelemetry.getInstance();
+     *
+     * @example
+     * // Get instance with custom tracer
+     * const customTracer = trace.getTracer('custom-tracer', '2.0.0');
+     * const telemetry = ArvoOpenTelemetry.getInstance({ tracer: customTracer });
+     *
+     * @remarks
+     * The tracer configuration is only applied when creating a new instance.
+     * Subsequent calls with different tracer configurations will not modify the existing instance.
      */
     static getInstance(config?: {
         tracer?: Tracer;
     }): ArvoOpenTelemetry;
+    /**
+     * Forces a reinitialization of the ArvoOpenTelemetry instance.
+     * Use this method with caution as it will affect all existing traces and spans.
+     *
+     * @param {Object} config - Configuration object for reinitializing the instance
+     * @param {Tracer} [config.tracer] - Optional custom OpenTelemetry tracer instance
+     * @param {boolean} [config.force=false] - If true, skips active span checks
+     *
+     * @throws {Error} If there are active spans and force is not set to true
+     * @throws {Error} If called before instance initialization
+     *
+     * @example
+     * // Safe reinitialization
+     * const customTracer = trace.getTracer('new-tracer', '2.0.0');
+     * ArvoOpenTelemetry.reinitialize({ tracer: customTracer });
+     */
+    static reinitialize(config: {
+        tracer?: Tracer;
+        force?: boolean;
+    }): void;
     /**
      * Creates and manages an active span for a given operation. This function provides two modes of operation:
      * 1. Automatic span management (default): Handles span lifecycle, status, and error recording

package/dist/OpenTelemetry/index.js

@@ -39,8 +39,27 @@ var ArvoOpenTelemetry = /** @class */ (function () {
         this.tracer = tracer !== null && tracer !== void 0 ? tracer : api_1.trace.getTracer('arvo-instrumentation', '1.0.0');
     }
     /**
-     * Gets the instance of ArvoOpenTelemetry
-     * @returns {ArvoOpenTelemetry} The singleton instance
+     * Gets or creates the singleton instance of ArvoOpenTelemetry.
+     * This method ensures only one instance of ArvoOpenTelemetry exists throughout the application.
+     *
+     * @param {Object} [config] - Optional configuration object for initializing the instance
+     * @param {Tracer} [config.tracer] - Optional custom OpenTelemetry tracer instance.
+     *                                   If not provided, defaults to a tracer with name 'arvo-instrumentation'
+     *
+     * @returns {ArvoOpenTelemetry} The singleton instance of ArvoOpenTelemetry
+     *
+     * @example
+     * // Get instance with default tracer
+     * const telemetry = ArvoOpenTelemetry.getInstance();
+     *
+     * @example
+     * // Get instance with custom tracer
+     * const customTracer = trace.getTracer('custom-tracer', '2.0.0');
+     * const telemetry = ArvoOpenTelemetry.getInstance({ tracer: customTracer });
+     *
+     * @remarks
+     * The tracer configuration is only applied when creating a new instance.
+     * Subsequent calls with different tracer configurations will not modify the existing instance.
      */
     ArvoOpenTelemetry.getInstance = function (config) {
         if (ArvoOpenTelemetry.instance === null) {
@@ -48,6 +67,37 @@ var ArvoOpenTelemetry = /** @class */ (function () {
         }
         return ArvoOpenTelemetry.instance;
     };
+    /**
+     * Forces a reinitialization of the ArvoOpenTelemetry instance.
+     * Use this method with caution as it will affect all existing traces and spans.
+     *
+     * @param {Object} config - Configuration object for reinitializing the instance
+     * @param {Tracer} [config.tracer] - Optional custom OpenTelemetry tracer instance
+     * @param {boolean} [config.force=false] - If true, skips active span checks
+     *
+     * @throws {Error} If there are active spans and force is not set to true
+     * @throws {Error} If called before instance initialization
+     *
+     * @example
+     * // Safe reinitialization
+     * const customTracer = trace.getTracer('new-tracer', '2.0.0');
+     * ArvoOpenTelemetry.reinitialize({ tracer: customTracer });
+     */
+    ArvoOpenTelemetry.reinitialize = function (config) {
+        if (!ArvoOpenTelemetry.instance) {
+            throw new Error('Cannot reinitialize before initialization. Call getInstance first.');
+        }
+        // Check for active spans unless force is true
+        if (!config.force) {
+            var activeSpan = api_1.trace.getActiveSpan();
+            if (activeSpan) {
+                throw new Error('Cannot reinitialize while spans are active. ' +
+                    'Either end all spans or use force: true (not recommended)');
+            }
+        }
+        // Create new instance
+        ArvoOpenTelemetry.instance = new ArvoOpenTelemetry(config.tracer);
+    };
     /**
      * Creates and manages an active span for a given operation. This function provides two modes of operation:
      * 1. Automatic span management (default): Handles span lifecycle, status, and error recording

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arvo-core",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "This core package contains all the core classes and components of the Arvo Event Driven System",
   "main": "dist/index.js",
   "scripts": {