@oas-tools/oas-telemetry 0.7.1 → 0.8.0-alpha.1

package/.env.example

@@ -10,19 +10,33 @@ OASTLM_BOOT_ENV=
 OASTLM_BOOT_MODULE_DISABLED=
 # Logging level for the boot process | Possible values: "DEBUG", "INFO", "WARNING", "ERROR", "NONE" | Default: "INFO"
 OASTLM_BOOT_LOG_LEVEL=
-# The name of your application or service | Default: "SERVICE-<random-uuid>"
+# The name of your application or service | Default: "unkown service"
 OASTLM_BOOT_SERVICE_NAME=
+# Base URL path for telemetry endpoints (must be set at boot time, cannot be changed at runtime) | Default: "/oas-telemetry"
+OASTLM_BOOT_BASE_URL=
+
+# BOOT-AUTO-INSTRUMENTATION CONFIGURATION --------------------------------
+# These variables control the auto-instrumentation registration at boot time.
+# ----------------------------------------------------------------------
+# Disable Node.js instrumentation auto-registration | Possible values: "true", "false" | Default: "false"
+OASTLM_BOOT_AUTOINSTRUMENTATIONS_NODE_DISABLED=
+# Disable logs instrumentation auto-registration | Possible values: "true", "false" | Default: "false"
+OASTLM_BOOT_AUTOINSTRUMENTATIONS_LOGS_DISABLED=
 
 
 # CONFIGURATION --------------------------------------------------------
 # These variables are used to override the configuration when oasTelemetry(config) is called.
 # ----------------------------------------------------------------------
 
-# Base URL for telemetry | Default: "/telemetry"
-OASTLM_CONFIG_GENERAL_BASE_URL=
 # Specification file name | Default: null
 OASTLM_CONFIG_GENERAL_SPEC_FILE_NAME=
 
+# Storage path: empty string = in-memory, else = disk storage at specified path | Default: empty string (in-memory)
+OASTLM_CONFIG_STORAGE_PATH=
+# Optional override for startup disk import behavior
+# Priority: OASTLM_CONFIG_STORAGE_LOAD_FROM_START > userConfig.storage.loadFromStart > defaultConfig
+OASTLM_CONFIG_STORAGE_LOAD_FROM_START=
+
 
 # Enable authentication | Possible values: "true", "false" | Default: "false"
 OASTLM_CONFIG_AUTH_ENABLED=

package/README.md

@@ -92,7 +92,6 @@ You can also customize the telemetry configuration by passing options to the mid
 ```js
 export const customTelemetryConfig = {
   general: {
-    baseUrl: "/custom-telemetry",
     specFileName: "oas.json",
     spec: null,
   },
@@ -162,7 +161,7 @@ app.use(oasTelemetry(customTelemetryConfig));
 
 ## Telemetry UI
 
-You can access the telemetry UI at the endpoint `/telemetry` (or `/custom-telemetry` if you set the `baseURL` option). This UI provides a user-friendly interface to interact with the telemetry data collected by the middleware.
+You can access the telemetry UI at the endpoint `/oas-telemetry` (or at a custom path if you set the `OASTLM_BOOT_BASE_URL` environment variable). This UI provides a user-friendly interface to interact with the telemetry data collected by the middleware.
 
 ## Rest API Endpoints Overview
 

package/dist/cjs/config/bootConfig.cjs

@@ -1,20 +1,22 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
 exports.bootEnvVariables = void 0;
-var _dotenv = _interopRequireDefault(require("dotenv"));
-var _crypto = require("crypto");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const dotenv_1 = __importDefault(require("dotenv"));
 if (process.env.NODE_ENV !== 'test') {
-  _dotenv.default.config();
+    dotenv_1.default.config();
 }
 // This variables can NOT be configured via oasTelemetry(config)
 // They are used at the import of the library
-const bootEnvVariables = exports.bootEnvVariables = {
-  OASTLM_BOOT_ENV: process.env.OASTLM_BOOT_ENV || process.env.NODE_ENV || 'production',
-  OASTLM_BOOT_MODULE_DISABLED: process.env.OASTLM_BOOT_MODULE_DISABLED === 'true',
-  OASTLM_BOOT_LOG_LEVEL: process.env.OASTLM_BOOT_LOG_LEVEL || 'INFO',
-  OASTLM_BOOT_SERVICE_NAME: process.env.OASTLM_BOOT_SERVICE_NAME || `SERVICE-${(0, _crypto.randomUUID)().slice(0, 8).toUpperCase()}`
-};
+exports.bootEnvVariables = {
+    OASTLM_BOOT_ENV: process.env.OASTLM_BOOT_ENV || process.env.NODE_ENV || 'production',
+    OASTLM_BOOT_MODULE_DISABLED: process.env.OASTLM_BOOT_MODULE_DISABLED === 'true',
+    OASTLM_BOOT_LOG_LEVEL: process.env.OASTLM_BOOT_LOG_LEVEL || 'INFO',
+    OASTLM_BOOT_SERVICE_NAME: process.env.OASTLM_BOOT_SERVICE_NAME || 'unkown service',
+    OASTLM_BOOT_BASE_URL: process.env.OASTLM_BOOT_BASE_URL || '/oas-telemetry',
+    OASTLM_BOOT_AUTOINSTRUMENTATIONS_NODE_DISABLED: process.env.OASTLM_BOOT_AUTOINSTRUMENTATIONS_NODE_DISABLED == 'true',
+    OASTLM_BOOT_AUTOINSTRUMENTATIONS_LOGS_DISABLED: process.env.OASTLM_BOOT_AUTOINSTRUMENTATIONS_LOGS_DISABLED == 'true',
+};
+// REMEMBER TO UPDATE THE .env.example FILE WITH ANY NEW BOOT VARIABLE ADDED HERE.

package/dist/cjs/config/config.cjs

@@ -1,147 +1,142 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
 exports.getConfig = exports.defaultConfig = void 0;
-var _lodash = _interopRequireDefault(require("lodash.merge"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const lodash_merge_1 = __importDefault(require("lodash.merge"));
 // Environment-level config (highest priority)
 // If NOT defined, it should return UNDEFINED so it dose not override the userConfig or defaultConfig.
 // Thats why we use getParsedEnvVar with no default value.
 const loadEnv = () => {
-  return {
-    general: {
-      baseUrl: getParsedEnvVar("OASTLM_CONFIG_GENERAL_BASE_URL"),
-      specFileName: getParsedEnvVar("OASTLM_CONFIG_GENERAL_SPEC_FILE_NAME")
-      // spec Not settable via env
-    },
-    auth: {
-      enabled: getParsedEnvVar("OASTLM_CONFIG_AUTH_ENABLED", v => v === "true"),
-      password: getParsedEnvVar("OASTLM_CONFIG_AUTH_PASSWORD"),
-      jwtSecret: getParsedEnvVar("OASTLM_CONFIG_AUTH_JWT_SECRET"),
-      accessTokenMaxAge: getParsedEnvVar("OASTLM_CONFIG_AUTH_ACCESS_TOKEN_MAX_AGE", v => parseInt(v, 10)),
-      refreshTokenMaxAge: getParsedEnvVar("OASTLM_CONFIG_AUTH_REFRESH_TOKEN_MAX_AGE", v => parseInt(v, 10))
-    },
-    traces: {
-      memoryExporter: {
-        enabled: getParsedEnvVar("OASTLM_CONFIG_TRACES_MEMORY_EXPORTER_ENABLED", v => v === "true"),
-        retentionTimeSeconds: getParsedEnvVar("OASTLM_CONFIG_TRACES_MEMORY_EXPORTER_RETENTION_TIME_SECONDS", v => parseInt(v, 10))
-        // filters NOT settable via env
-      }
-    },
-    metrics: {
-      mainMetricReaderOptions: {
-        exportIntervalMillis: getParsedEnvVar("OASTLM_CONFIG_METRICS_MAIN_READER_EXPORT_INTERVAL", v => parseInt(v, 10))
-        // metricProducers NOT settable via env
-      },
-      memoryExporter: {
-        enabled: getParsedEnvVar("OASTLM_CONFIG_METRICS_MEMORY_EXPORTER_ENABLED", v => v === "true"),
-        retentionTimeSeconds: getParsedEnvVar("OASTLM_CONFIG_METRICS_MEMORY_EXPORTER_RETENTION_TIME_SECONDS", v => parseInt(v, 10))
-        // filters NOT settable via env
-      }
-    },
-    logs: {
-      memoryExporter: {
-        enabled: getParsedEnvVar("OASTLM_CONFIG_LOGS_MEMORY_EXPORTER_ENABLED", v => v === "true"),
-        retentionTimeSeconds: getParsedEnvVar("OASTLM_CONFIG_LOGS_MEMORY_EXPORTER_RETENTION_TIME_SECONDS", v => parseInt(v, 10))
-        // filters NOT settable via env
-      }
-    },
-    ai: {
-      openAIKey: getParsedEnvVar("OASTLM_CONFIG_AI_OPENAI_KEY"),
-      openAIModel: getParsedEnvVar("OASTLM_CONFIG_AI_OPENAI_MODEL", v => v || "gpt-3.5-turbo"),
-      extraContextPrompts: getParsedEnvVar("OASTLM_CONFIG_AI_EXTRA_CONTEXT_PROMPTS", v => v ? v.split(',') : [])
-    }
-  };
+    return {
+        general: {
+            specFileName: getParsedEnvVar("OASTLM_CONFIG_GENERAL_SPEC_FILE_NAME"),
+            // spec Not settable via env
+        },
+        storage: {
+            path: getParsedEnvVar("OASTLM_CONFIG_STORAGE_PATH"),
+            loadFromStart: getParsedEnvVar("OASTLM_CONFIG_STORAGE_LOAD_FROM_START", (v) => v === "true"),
+        },
+        auth: {
+            enabled: getParsedEnvVar("OASTLM_CONFIG_AUTH_ENABLED", (v) => v === "true"),
+            password: getParsedEnvVar("OASTLM_CONFIG_AUTH_PASSWORD"),
+            jwtSecret: getParsedEnvVar("OASTLM_CONFIG_AUTH_JWT_SECRET"),
+            accessTokenMaxAge: getParsedEnvVar("OASTLM_CONFIG_AUTH_ACCESS_TOKEN_MAX_AGE", (v) => parseInt(v, 10)),
+            refreshTokenMaxAge: getParsedEnvVar("OASTLM_CONFIG_AUTH_REFRESH_TOKEN_MAX_AGE", (v) => parseInt(v, 10)),
+        },
+        traces: {
+            memoryExporter: {
+                enabled: getParsedEnvVar("OASTLM_CONFIG_TRACES_MEMORY_EXPORTER_ENABLED", (v) => v === "true"),
+                retentionTimeSeconds: getParsedEnvVar("OASTLM_CONFIG_TRACES_MEMORY_EXPORTER_RETENTION_TIME_SECONDS", (v) => parseInt(v, 10)),
+                // filters NOT settable via env
+            }
+        },
+        metrics: {
+            mainMetricReaderOptions: {
+                exportIntervalMillis: getParsedEnvVar("OASTLM_CONFIG_METRICS_MAIN_READER_EXPORT_INTERVAL", (v) => parseInt(v, 10)),
+                // metricProducers NOT settable via env
+            },
+            memoryExporter: {
+                enabled: getParsedEnvVar("OASTLM_CONFIG_METRICS_MEMORY_EXPORTER_ENABLED", (v) => v === "true"),
+                retentionTimeSeconds: getParsedEnvVar("OASTLM_CONFIG_METRICS_MEMORY_EXPORTER_RETENTION_TIME_SECONDS", (v) => parseInt(v, 10)),
+                // filters NOT settable via env
+            }
+        },
+        logs: {
+            memoryExporter: {
+                enabled: getParsedEnvVar("OASTLM_CONFIG_LOGS_MEMORY_EXPORTER_ENABLED", (v) => v === "true"),
+                retentionTimeSeconds: getParsedEnvVar("OASTLM_CONFIG_LOGS_MEMORY_EXPORTER_RETENTION_TIME_SECONDS", (v) => parseInt(v, 10)),
+                // filters NOT settable via env
+            },
+        },
+        ai: {
+            openAIKey: getParsedEnvVar("OASTLM_CONFIG_AI_OPENAI_KEY"),
+            openAIModel: getParsedEnvVar("OASTLM_CONFIG_AI_OPENAI_MODEL", (v) => v || "gpt-3.5-turbo"),
+            extraContextPrompts: getParsedEnvVar("OASTLM_CONFIG_AI_EXTRA_CONTEXT_PROMPTS", (v) => v ? v.split(',') : []),
+        },
+    };
 };
 // This defines de OasTlmConfig type, which is used throughout the library.
 // Please ensure that all possible types are included here, not only the defaults.
 // e.g. .ai.openAIKey: null as string | null, default is null, but can be set to a string.
 // NOTE: Some BOOT environment variables (e.g., OASTLM_BOOT_MODULE_DISABLED) are accessed before this config is loaded.
 // This means certain settings may affect application startup behavior outside of this configuration system.
-const defaultConfig = exports.defaultConfig = {
-  general: {
-    baseUrl: "/telemetry",
-    specFileName: null,
-    // e.g. "oas.json" or null if not provided
-    spec: null,
-    // e.g. JSON.stringify(oasSpec) or null if not provided,
-    uiPath: "/oas-telemetry-ui" // path to the UI, e.g. "/oas-telemetry-ui" WARN: This must match the UI package's App.tsx "oas-telemetry-ui" path
-  },
-  auth: {
-    enabled: false,
-    password: "oas-telemetry-password",
-    jwtSecret: "oas-telemetry-secret",
-    accessTokenMaxAge: 1000 * 60 * 5,
-    // 5 minutes
-    refreshTokenMaxAge: 1000 * 60 * 60 * 24 * 7 // 7 days
-  },
-  ai: {
-    openAIKey: null,
-    openAIModel: "gpt-3.5-turbo",
-    extraContextPrompts: [] // e.g. ["Provide detailed explanations", "Use simple language"]
-  },
-  traces: {
-    extraExporters: [],
-    // e.g. [new ConsoleSpanExporter()]
-    extraProcessors: [],
-    // e.g. [new SimpleSpanProcessor(new ConsoleSpanExporter())]
-    mainProcessorOptions: {
-      config: undefined
+exports.defaultConfig = {
+    general: {
+        specFileName: null, // e.g. "oas.json" or null if not provided
+        spec: null, // e.g. JSON.stringify(oasSpec) or null if not provided,
+        uiPath: "/oas-telemetry-ui", // path to the UI, e.g. "/oas-telemetry-ui" WARN: This must match the UI package's App.tsx "oas-telemetry-ui" path
     },
-    memoryExporter: {
-      enabled: true,
-      // auto start exporting.
-      retentionTimeSeconds: 60 * 60 // 1 hour
+    storage: {
+        path: null, // Optional disk persistence directory.
+        loadFromStart: true, // If true, import persisted telemetry into memory at startup.
     },
-    filters: [] // future feature, currently not used
-  },
-  metrics: {
-    mainMetricReaderOptions: {
-      exportIntervalMillis: 1000 * 60,
-      // 60 seconds
-      metricProducers: [] // experimental by OpenTelemetry, not used by OAS-TLM yet
+    auth: {
+        enabled: false,
+        password: "oas-telemetry-password",
+        jwtSecret: "oas-telemetry-secret",
+        accessTokenMaxAge: 1000 * 60 * 5, // 5 minutes
+        refreshTokenMaxAge: 1000 * 60 * 60 * 24 * 7, // 7 days
     },
-    extraReaders: [],
-    // e.g. [new PrometheusExporter()]
-    extraViews: [],
-    // e.g. [new MetricView({ name: 'my_metric', labels: ['env'] })]
-    memoryExporter: {
-      enabled: true,
-      retentionTimeSeconds: 60 * 60 // 1 hour
+    ai: {
+        openAIKey: null,
+        openAIModel: "gpt-3.5-turbo",
+        extraContextPrompts: [], // e.g. ["Provide detailed explanations", "Use simple language"]
     },
-    filters: [] // future feature, currently not used
-  },
-  logs: {
-    extraExporters: [],
-    // e.g. [new ConsoleLogRecordExporter()]
-    extraProcessors: [],
-    // e.g. [new SimpleLogRecordProcessor(new ConsoleLogRecordExporter())]
-    memoryExporter: {
-      enabled: true,
-      retentionTimeSeconds: 60 * 60 // 1 hour
+    traces: {
+        extraExporters: [], // e.g. [new ConsoleSpanExporter()]
+        extraProcessors: [], // e.g. [new SimpleSpanProcessor(new ConsoleSpanExporter())]
+        mainProcessorOptions: {
+            config: undefined
+        },
+        memoryExporter: {
+            enabled: true, // auto start exporting.
+            retentionTimeSeconds: 60 * 60, // 1 hour
+        },
+        filters: [], // future feature, currently not used
     },
-    filters: [] // future feature, currently not used
-  },
-  plugins: {
-    enabled: true,
-    // future feature
-    extraPlugins: [] // future feature
-  }
+    metrics: {
+        mainMetricReaderOptions: {
+            exportIntervalMillis: 1000 * 60, // 60 seconds
+            metricProducers: [], // experimental by OpenTelemetry, not used by OAS-TLM yet
+        },
+        extraReaders: [], // e.g. [new PrometheusExporter()]
+        extraViews: [], // e.g. [new MetricView({ name: 'my_metric', labels: ['env'] })]
+        memoryExporter: {
+            enabled: true,
+            retentionTimeSeconds: 60 * 60, // 1 hour
+        },
+        filters: [], // future feature, currently not used
+    },
+    logs: {
+        extraExporters: [], // e.g. [new ConsoleLogRecordExporter()]
+        extraProcessors: [], // e.g. [new SimpleLogRecordProcessor(new ConsoleLogRecordExporter())]
+        memoryExporter: {
+            enabled: true,
+            retentionTimeSeconds: 60 * 60, // 1 hour
+        },
+        filters: [], // future feature, currently not used
+    },
+    plugins: {
+        enabled: true, // future feature
+        extraPlugins: [], // future feature
+    },
+    instrumentations: [],
 };
 // Helper to get an environment variable with optional transform
 const getParsedEnvVar = (envKey, transform) => {
-  const rawValue = process.env[envKey];
-  // Treat undefined and "" in env as undefined (skip)
-  if (rawValue === undefined || rawValue === "") return undefined;
-  if (typeof transform === 'function') {
-    return transform(rawValue);
-  }
-  return rawValue;
+    const rawValue = process.env[envKey];
+    // Treat undefined and "" in env as undefined (skip)
+    if (rawValue === undefined || rawValue === "")
+        return undefined;
+    if (typeof transform === 'function') {
+        return transform(rawValue);
+    }
+    return rawValue;
 };
-const getConfig = (userConfig, fallbackConfig = defaultConfig, envConfig = loadEnv()) => {
-  // environment variables OVERRIDE userConfig OVERRIDE fallbackConfig
-  return (0, _lodash.default)({}, fallbackConfig, userConfig, envConfig);
+const getConfig = (userConfig, fallbackConfig = exports.defaultConfig, envConfig = loadEnv()) => {
+    // environment variables OVERRIDE userConfig OVERRIDE fallbackConfig
+    return (0, lodash_merge_1.default)({}, fallbackConfig, userConfig, envConfig);
 };
-exports.getConfig = getConfig;
+exports.getConfig = getConfig;

package/dist/cjs/config/config.types.cjs

@@ -1,5 +1,2 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/docs/openapi.yaml

@@ -31,8 +31,8 @@ servers:
       port:
         default: "3000"
       basePath:
-        default: telemetry
-        description: Base path for all endpoints. Can be customized, e.g. "myCustomTelemetryPath"
+        default: oas-telemetry
+        description: Base path for all endpoints. Configured via OASTLM_BOOT_BASE_URL environment variable
 
 tags:
   - name: traces
@@ -326,6 +326,44 @@ paths:
                     type: string
                     example: Invalid retention time. Must be a positive number.
 
+  /traces/export:
+    get:
+      tags:
+        - traces
+      summary: Export collected traces
+      description: Export all collected traces in line-delimited JSON format
+      responses:
+        '200':
+          description: Traces exported successfully
+          content:
+            application/json:
+              schema:
+                type: string
+
+  /traces/import:
+    post:
+      tags:
+        - traces
+      summary: Import traces
+      description: Import traces from line-delimited JSON format
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: string
+      responses:
+        '200':
+          description: Traces imported successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: Traces imported successfully
+
   /metrics:
     get:
       summary: Get collected metrics
@@ -548,6 +586,69 @@ paths:
                     type: string
                     example: Invalid retention time. Must be a positive number.
 
+  /metrics/export:
+    get:
+      tags:
+        - metrics
+      summary: Export collected metrics
+      description: Export all collected metrics in line-delimited JSON format
+      responses:
+        '200':
+          description: Metrics exported successfully
+          content:
+            application/json:
+              schema:
+                type: string
+
+  /metrics/import:
+    post:
+      tags:
+        - metrics
+      summary: Import metrics
+      description: Import metrics from line-delimited JSON format
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: string
+      responses:
+        '200':
+          description: Metrics imported successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: Metrics imported successfully
+
+  /metrics/stats:
+    get:
+      tags:
+        - metrics
+      summary: Get metrics statistics
+      description: Get statistics about collected metrics
+      responses:
+        '200':
+          description: Metrics statistics retrieved successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  totalMetrics:
+                    type: number
+                    example: 42
+                  activeMetrics:
+                    type: number
+                    example: 35
+                  retentionTime:
+                    type: number
+                    description: Retention time in seconds
+                    example: 3600
+
   /logs:
     get:
       summary: Get collected logs
@@ -683,6 +784,44 @@ paths:
                     type: string
                     example: Invalid regex in query
 
+  /logs/export:
+    get:
+      tags:
+        - logs
+      summary: Export collected logs
+      description: Export all collected logs in line-delimited JSON format
+      responses:
+        '200':
+          description: Logs exported successfully
+          content:
+            application/json:
+              schema:
+                type: string
+
+  /logs/import:
+    post:
+      tags:
+        - logs
+      summary: Import logs
+      description: Import logs from line-delimited JSON format
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: string
+      responses:
+        '200':
+          description: Logs imported successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: Logs imported successfully
+
   /utils/spec:
     get:
       summary: Get OpenAPI spec in JSON
@@ -842,14 +981,14 @@ paths:
                     type: string
                     example: Started generating mock logs
 
-  /utils/generate-wait/{seconds}:
+  /utils/generate-wait:
     get:
       summary: Wait for the specified seconds
       tags:
         - utils
       parameters:
         - name: seconds
-          in: path
+          in: query
           required: false
           schema:
             type: integer
@@ -867,6 +1006,21 @@ paths:
                     type: number
                     example: 2
 
+  /utils/oas-telemetry-spec:
+    get:
+      summary: Get OAS-Telemetry specification
+      tags:
+        - utils
+      description: Retrieve the OpenAPI specification for OAS-Telemetry
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                description: OpenAPI specification
+
   /health:
     get:
       summary: Health check

package/dist/cjs/index.cjs

@@ -1,38 +1,35 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = oasTelemetry;
-var _bootConfig = require("./config/bootConfig.cjs");
-require("./telemetry/initializeTelemetry.cjs");
-var _logger = _interopRequireDefault(require("./utils/logger.cjs"));
-var _config = require("./config/config.cjs");
-var _express = require("express");
-var _routesManager = require("./routesManager.cjs");
-var _telemetryConfigurator = require("./telemetry/telemetryConfigurator.cjs");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// Load environment variables before any other imports
-// Initialize OpenTelemetry instrumentation
-
-// WARN: If changed the API, also change in packages/lib/src/types/cjs-index.d.ts (used for CJS compilation)
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oasTelemetry = oasTelemetry;
+require("./config/bootConfig.cjs"); // Load environment variables before any other imports
+require("./telemetry/initializeTelemetry.cjs"); // Initialize OpenTelemetry instrumentation
+const logger_js_1 = __importDefault(require("./utils/logger.cjs"));
+const config_js_1 = require("./config/config.cjs");
+const express_1 = require("express");
+const routesManager_js_1 = require("./routesManager.cjs");
+const telemetryConfigurator_js_1 = require("./telemetry/telemetryConfigurator.cjs");
+const telemetryRegistry_js_1 = require("./telemetry/telemetryRegistry.cjs");
+const bootConfig_js_1 = require("./config/bootConfig.cjs");
 /**
  * Returns the OAS-Telemetry middleware.
  * All parameters are optional. However, either `spec` or `specFileName` must be provided to enable endpoint filtering.
  */
 function oasTelemetry(oasTlmInputConfig) {
-  const router = (0, _express.Router)();
-  // This environment variable cannot be set via the config object,
-  // as it is required to disable OpenTelemetry SDK initialization,
-  // which occurs during the first import at the top of this file.
-  if (_bootConfig.bootEnvVariables.OASTLM_BOOT_MODULE_DISABLED) {
+    if ((0, telemetryRegistry_js_1.isTelemetryConfigured)()) {
+        return (0, telemetryRegistry_js_1.getTelemetryRouter)();
+    }
+    const router = (0, express_1.Router)();
+    if (bootConfig_js_1.bootEnvVariables.OASTLM_BOOT_MODULE_DISABLED) {
+        (0, telemetryRegistry_js_1.setTelemetryRouter)(router);
+        return router;
+    }
+    const oasTlmConfig = (0, config_js_1.getConfig)(oasTlmInputConfig);
+    logger_js_1.default.info("BaseUrl: ", bootConfig_js_1.bootEnvVariables.OASTLM_BOOT_BASE_URL);
+    (0, telemetryConfigurator_js_1.configureTelemetry)(oasTlmConfig);
+    (0, routesManager_js_1.configureRoutes)(router, oasTlmConfig);
+    (0, telemetryRegistry_js_1.setTelemetryRouter)(router);
     return router;
-  }
-  const oasTlmConfig = (0, _config.getConfig)(oasTlmInputConfig);
-  _logger.default.info("BaseUrl: ", oasTlmConfig.general.baseUrl);
-  if (!oasTlmConfig.general.spec && !oasTlmConfig.general.specFileName) _logger.default.warn("No spec provided, endpoint filtering will not be available. Please provide either `spec` or `specFileName` in the configuration.");
-  (0, _telemetryConfigurator.configureTelemetry)(oasTlmConfig);
-  (0, _routesManager.configureRoutes)(router, oasTlmConfig);
-  return router;
 }
-module.exports = exports.default;