@naylence/runtime 0.3.5-test.928 → 0.3.5-test.930

package/dist/node/index.cjs

@@ -14,12 +14,12 @@ var fastify = require('fastify');
 var websocketPlugin = require('@fastify/websocket');
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.928
+// Generated from package.json version: 0.3.5-test.930
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.928';
+const VERSION = '0.3.5-test.930';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -28371,239 +28371,10 @@ var noopTraceEmitterFactory = /*#__PURE__*/Object.freeze({
     default: NoopTraceEmitterFactory
 });
 
-const logger$q = getLogger('naylence.fame.telemetry.otel_setup');
-const stringFrom = (...codes) => String.fromCharCode(...codes);
-const OTEL_PREFIX = `${stringFrom(64, 111, 112, 101, 110, 116, 101, 108, 101, 109, 101, 116, 114, 121)}${stringFrom(47)}`;
-const OTEL_API_SPEC = `${OTEL_PREFIX}${stringFrom(97, 112, 105)}`;
-const OTEL_RESOURCES_SPEC = `${OTEL_PREFIX}${stringFrom(114, 101, 115, 111, 117, 114, 99, 101, 115)}`;
-const OTEL_TRACE_NODE_SPEC = `${OTEL_PREFIX}${stringFrom(115, 100, 107, 45, 116, 114, 97, 99, 101, 45, 110, 111, 100, 101)}`;
-const OTEL_TRACE_BASE_SPEC = `${OTEL_PREFIX}${stringFrom(115, 100, 107, 45, 116, 114, 97, 99, 101, 45, 98, 97, 115, 101)}`;
-const OTEL_EXPORTER_HTTP_SPEC = `${OTEL_PREFIX}${stringFrom(101, 120, 112, 111, 114, 116, 101, 114, 45, 116, 114, 97, 99, 101, 45, 111, 116, 108, 112, 45, 104, 116, 116, 112)}`;
-let registeredOtel = null;
-async function setupOtel(options) {
-    const normalized = normalizeSetupOtelOptions(options);
-    try {
-        if (registeredOtel) {
-            logger$q.debug('open_telemetry_reusing_provider', {
-                service_name: normalized.serviceName,
-            });
-            return registeredOtel.control;
-        }
-        const [apiModule, resourcesModule, nodeModule, traceBaseModule] = await Promise.all([
-            import(OTEL_API_SPEC),
-            import(OTEL_RESOURCES_SPEC),
-            import(OTEL_TRACE_NODE_SPEC),
-            import(OTEL_TRACE_BASE_SPEC),
-        ]);
-        const { trace } = apiModule;
-        const { defaultResource, resourceFromAttributes } = resourcesModule;
-        const { NodeTracerProvider } = nodeModule;
-        const { BatchSpanProcessor, ConsoleSpanExporter, ParentBasedSampler, AlwaysOnSampler, AlwaysOffSampler, TraceIdRatioBasedSampler, } = traceBaseModule;
-        const currentProvider = trace.getTracerProvider();
-        if (currentProvider && currentProvider instanceof NodeTracerProvider) {
-            return null;
-        }
-        if (currentProvider &&
-            currentProvider.constructor?.name === 'NodeTracerProvider') {
-            logger$q.debug('open_telemetry_existing_node_provider', {
-                service_name: normalized.serviceName,
-            });
-            return null;
-        }
-        logger$q.debug('open_telemetry_initializing', {
-            service_name: normalized.serviceName,
-            endpoint: normalized.endpoint ?? null,
-            environment: normalized.environment ?? null,
-            sampler: normalized.sampler ?? null,
-            headers_present: Boolean(normalized.headers && Object.keys(normalized.headers).length),
-        });
-        const sampler = resolveSampler(normalized.sampler, {
-            ParentBasedSampler,
-            AlwaysOnSampler,
-            AlwaysOffSampler,
-            TraceIdRatioBasedSampler,
-        });
-        const baseResource = defaultResource();
-        const mergedResource = resourceFromAttributes({
-            'service.name': normalized.serviceName,
-            'service.instance.id': generateInstanceId(),
-            'deployment.environment': normalized.environment ?? 'dev',
-        });
-        const resource = baseResource.merge(mergedResource);
-        const exporter = await resolveExporter(normalized.endpoint ?? undefined, normalized.headers, ConsoleSpanExporter);
-        const spanProcessor = new BatchSpanProcessor(exporter);
-        const provider = new NodeTracerProvider({
-            resource,
-            sampler,
-            spanProcessors: [spanProcessor],
-        });
-        provider.register();
-        logger$q.debug('open_telemetry_initialized', {
-            service_name: normalized.serviceName,
-            exporter: exporter.constructor?.name ?? 'unknown_exporter',
-        });
-        const control = {
-            forceFlush: async () => {
-                try {
-                    await provider.forceFlush();
-                }
-                catch (flushError) {
-                    logger$q.warning('open_telemetry_force_flush_failed', {
-                        error: flushError instanceof Error
-                            ? flushError.message
-                            : String(flushError),
-                    });
-                }
-            },
-            shutdown: async () => {
-                try {
-                    await provider.shutdown();
-                }
-                catch (shutdownError) {
-                    logger$q.warning('open_telemetry_shutdown_failed', {
-                        error: shutdownError instanceof Error
-                            ? shutdownError.message
-                            : String(shutdownError),
-                    });
-                }
-                finally {
-                    registeredOtel = null;
-                }
-            },
-        };
-        registeredOtel = {
-            provider,
-            control,
-        };
-        return control;
-    }
-    catch (error) {
-        logger$q.error('open_telemetry_not_available', {
-            error: error instanceof Error ? error.message : String(error),
-            stack: error instanceof Error && error.stack ? error.stack : undefined,
-        });
-        return null;
-    }
-}
-function normalizeSetupOtelOptions(options) {
-    const source = (options ?? {});
-    const serviceName = extractNonEmptyString$1(pickFirst$2(source, ['serviceName', 'service_name'])) ??
-        'naylence-service';
-    const endpoint = extractNonEmptyString$1(pickFirst$2(source, ['endpoint', 'otlpEndpoint', 'otlp_endpoint'])) ?? null;
-    const environment = extractNonEmptyString$1(pickFirst$2(source, [
-        'environment',
-        'deploymentEnvironment',
-        'deployment_environment',
-    ])) ?? null;
-    const sampler = extractNonEmptyString$1(pickFirst$2(source, ['sampler', 'samplingStrategy', 'sampling_strategy'])) ?? null;
-    const headers = extractHeaders$1(pickFirst$2(source, ['headers', 'otlpHeaders', 'otlp_headers']));
-    return {
-        serviceName,
-        endpoint,
-        environment,
-        sampler,
-        headers: headers ?? undefined,
-    };
-}
-function pickFirst$2(source, keys) {
-    for (const key of keys) {
-        if (Object.prototype.hasOwnProperty.call(source, key)) {
-            const value = source[key];
-            if (value !== undefined) {
-                return value;
-            }
-        }
-    }
-    return undefined;
-}
-function extractNonEmptyString$1(value) {
-    if (typeof value === 'string') {
-        const trimmed = value.trim();
-        if (trimmed.length > 0) {
-            return trimmed;
-        }
-    }
-    return undefined;
-}
-function extractHeaders$1(value) {
-    if (!value || typeof value !== 'object') {
-        return null;
-    }
-    const headers = {};
-    for (const [key, raw] of Object.entries(value)) {
-        if (typeof raw === 'string') {
-            headers[key] = raw;
-        }
-    }
-    return Object.keys(headers).length > 0 ? headers : null;
-}
-function generateInstanceId() {
-    try {
-        if (typeof crypto !== 'undefined' &&
-            typeof crypto.randomUUID === 'function') {
-            return crypto.randomUUID().replace(/-/g, '');
-        }
-    }
-    catch {
-        // Ignore crypto availability errors
-    }
-    const random = Math.random().toString(16).slice(2);
-    return random.padEnd(32, '0').slice(0, 32);
-}
-function resolveSampler(samplerSetting, samplers) {
-    const normalized = (samplerSetting ?? 'parentbased_always_on').toLowerCase();
-    let base;
-    if (normalized === 'always_off') {
-        base = new samplers.AlwaysOffSampler();
-    }
-    else if (normalized === 'always_on' ||
-        normalized === 'parentbased_always_on') {
-        base = new samplers.AlwaysOnSampler();
-    }
-    else if (normalized.startsWith('ratio:')) {
-        const ratioValue = Number.parseFloat(normalized.slice('ratio:'.length));
-        const ratio = Number.isFinite(ratioValue)
-            ? Math.min(Math.max(ratioValue, 0), 1)
-            : 1;
-        base = new samplers.TraceIdRatioBasedSampler(ratio);
-    }
-    else {
-        base = new samplers.AlwaysOnSampler();
-    }
-    return new samplers.ParentBasedSampler({ root: base });
-}
-async function resolveExporter(endpoint, headers, ConsoleSpanExporter) {
-    if (endpoint) {
-        try {
-            const exporterModule = await import(OTEL_EXPORTER_HTTP_SPEC);
-            if ('OTLPTraceExporter' in exporterModule) {
-                const { OTLPTraceExporter } = exporterModule;
-                const exporterOptions = {
-                    url: endpoint,
-                };
-                if (headers && Object.keys(headers).length > 0) {
-                    exporterOptions.headers = headers;
-                }
-                logger$q.debug('open_telemetry_using_otlp_http_exporter', {
-                    endpoint,
-                    headers_present: Boolean(headers && Object.keys(headers).length),
-                });
-                return new OTLPTraceExporter(exporterOptions);
-            }
-        }
-        catch (error) {
-            logger$q.error('open_telemetry_exporter_not_available', {
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    }
-    logger$q.warning('open_telemetry_falling_back_to_console_exporter');
-    return new ConsoleSpanExporter();
-}
-
 let openTelemetryTraceEmitterModulePromise = null;
 let otelApiModulePromise = null;
-const logger$p = getLogger('naylence.fame.telemetry.open_telemetry_trace_emitter_factory');
+let otelSetupModulePromise = null;
+const logger$q = getLogger('naylence.fame.telemetry.open_telemetry_trace_emitter_factory');
 const MISSING_OTEL_HELP_MESSAGE = 'Missing optional OpenTelemetry dependency. Install @opentelemetry/api (and related packages) to enable trace emission.';
 function getOpenTelemetryTraceEmitterModule() {
     if (!openTelemetryTraceEmitterModulePromise) {
@@ -28621,6 +28392,14 @@ function getOtelApiModule() {
     }
     return otelApiModulePromise;
 }
+function getOtelSetupModule() {
+    if (!otelSetupModulePromise) {
+        otelSetupModulePromise = safeImport(() => Promise.resolve().then(function () { return otelSetup; }), '@opentelemetry/api', {
+            helpMessage: MISSING_OTEL_HELP_MESSAGE,
+        });
+    }
+    return otelSetupModulePromise;
+}
 const FACTORY_META$Z = {
     base: TRACE_EMITTER_FACTORY_BASE_TYPE,
     key: 'OpenTelemetryTraceEmitter',
@@ -28644,7 +28423,7 @@ class OpenTelemetryTraceEmitterFactory extends TraceEmitterFactory {
                 await AuthInjectionStrategyFactory.createAuthInjectionStrategy(normalized.auth);
             try {
                 await authStrategy.apply(mergedHeaders);
-                logger$p.info('trace_emitter_auth_applied', {
+                logger$q.info('trace_emitter_auth_applied', {
                     service_name: normalized.serviceName,
                 });
             }
@@ -28660,6 +28439,7 @@ class OpenTelemetryTraceEmitterFactory extends TraceEmitterFactory {
         }
         let lifecycle = null;
         try {
+            const { setupOtel } = await getOtelSetupModule();
             lifecycle = await setupOtel({
                 serviceName: normalized.serviceName,
                 endpoint: normalized.endpoint,
@@ -28667,7 +28447,7 @@ class OpenTelemetryTraceEmitterFactory extends TraceEmitterFactory {
                 sampler: normalized.sampler,
                 headers: Object.keys(mergedHeaders).length > 0 ? mergedHeaders : undefined,
             });
-            logger$p.debug('trace_emitter_lifecycle_acquired', {
+            logger$q.debug('trace_emitter_lifecycle_acquired', {
                 service_name: normalized.serviceName,
                 lifecycle_available: Boolean(lifecycle),
             });
@@ -28705,7 +28485,7 @@ class OpenTelemetryTraceEmitterFactory extends TraceEmitterFactory {
         }
         try {
             const emitter = new OpenTelemetryTraceEmitter(emitterOptions);
-            logger$p.debug('trace_emitter_created', {
+            logger$q.debug('trace_emitter_created', {
                 service_name: normalized.serviceName,
                 has_lifecycle: Boolean(lifecycle),
                 has_auth_strategy: Boolean(authStrategy),
@@ -28737,17 +28517,17 @@ function normalizeConfig$r(config) {
         };
     }
     const candidate = config;
-    const serviceName = extractString(pickFirst$1(candidate, ['serviceName', 'service_name'])) ??
+    const serviceName = extractString(pickFirst$2(candidate, ['serviceName', 'service_name'])) ??
         'naylence-service';
-    const endpoint = extractString(pickFirst$1(candidate, ['endpoint', 'otlpEndpoint', 'otlp_endpoint'])) ?? null;
-    const environment = extractString(pickFirst$1(candidate, [
+    const endpoint = extractString(pickFirst$2(candidate, ['endpoint', 'otlpEndpoint', 'otlp_endpoint'])) ?? null;
+    const environment = extractString(pickFirst$2(candidate, [
         'environment',
         'deploymentEnvironment',
         'deployment_environment',
     ])) ?? null;
-    const sampler = extractString(pickFirst$1(candidate, ['sampler', 'samplingStrategy', 'sampling_strategy'])) ?? null;
-    const headersFromConfig = extractHeaders(pickFirst$1(candidate, ['headers', 'otlpHeaders', 'otlp_headers']));
-    const authConfig = pickFirst$1(candidate, [
+    const sampler = extractString(pickFirst$2(candidate, ['sampler', 'samplingStrategy', 'sampling_strategy'])) ?? null;
+    const headersFromConfig = extractHeaders$1(pickFirst$2(candidate, ['headers', 'otlpHeaders', 'otlp_headers']));
+    const authConfig = pickFirst$2(candidate, [
         'auth',
     ]);
     return {
@@ -28765,7 +28545,7 @@ function extractString(value) {
     }
     return undefined;
 }
-function pickFirst$1(source, keys) {
+function pickFirst$2(source, keys) {
     for (const key of keys) {
         if (Object.prototype.hasOwnProperty.call(source, key)) {
             const value = source[key];
@@ -28776,7 +28556,7 @@ function pickFirst$1(source, keys) {
     }
     return undefined;
 }
-function extractHeaders(value) {
+function extractHeaders$1(value) {
     if (!value || typeof value !== 'object') {
         return null;
     }
@@ -28796,7 +28576,7 @@ var openTelemetryTraceEmitterFactory = /*#__PURE__*/Object.freeze({
     default: OpenTelemetryTraceEmitterFactory
 });
 
-const logger$o = getLogger('naylence.fame.telemetry.trace_emitter_profile_factory');
+const logger$p = getLogger('naylence.fame.telemetry.trace_emitter_profile_factory');
 const PROFILE_NAME_NOOP$1 = 'noop';
 const PROFILE_NAME_OPEN_TELEMETRY = 'open-telemetry';
 const ENV_VAR_TELEMETRY_SERVICE_NAME = 'FAME_TELEMETRY_SERVICE_NAME';
@@ -28824,7 +28604,7 @@ class TraceEmitterProfileFactory extends TraceEmitterFactory {
     async create(config, ...factoryArgs) {
         const normalized = normalizeTraceEmitterProfileConfig(config);
         const profileConfig = resolveProfileConfig$2(normalized.profile);
-        logger$o.debug('enabling_trace_emitter_profile', {
+        logger$p.debug('enabling_trace_emitter_profile', {
             profile: normalized.profile,
         });
         const traceEmitter = await TraceEmitterFactory.createTraceEmitter(profileConfig, {
@@ -29234,7 +29014,7 @@ var httpListenerFactory = /*#__PURE__*/Object.freeze({
     default: HttpListenerFactory
 });
 
-const logger$n = getLogger('naylence.fame.connector.http_stateless_connector');
+const logger$o = getLogger('naylence.fame.connector.http_stateless_connector');
 class HttpStatelessConnector extends BaseAsyncConnector {
     constructor(config, dependencies = {}) {
         super(config);
@@ -29280,7 +29060,7 @@ class HttpStatelessConnector extends BaseAsyncConnector {
         }
         catch (error) {
             if (error instanceof QueueFullError) {
-                logger$n.warning('receive_queue_full', {
+                logger$o.warning('receive_queue_full', {
                     url: this.url,
                 });
             }
@@ -29302,7 +29082,7 @@ class HttpStatelessConnector extends BaseAsyncConnector {
             });
             if (!response.ok) {
                 const statusText = response.statusText || 'HTTP error';
-                logger$n.error('http_request_failed', {
+                logger$o.error('http_request_failed', {
                     url: this.url,
                     status: response.status,
                     statusText,
@@ -29314,7 +29094,7 @@ class HttpStatelessConnector extends BaseAsyncConnector {
             if (error instanceof FameTransportClose) {
                 throw error;
             }
-            logger$n.error('http_request_error', {
+            logger$o.error('http_request_error', {
                 url: this.url,
                 error: error instanceof Error ? error.message : String(error),
             });
@@ -29752,7 +29532,7 @@ var inpageListenerFactory = /*#__PURE__*/Object.freeze({
     default: InPageListenerFactory
 });
 
-const logger$m = getLogger('naylence.fame.connector.websocket_connector_factory');
+const logger$n = getLogger('naylence.fame.connector.websocket_connector_factory');
 let sslLoader = null;
 function setWebSocketConnectorSslLoader(loader) {
     sslLoader = loader;
@@ -30036,7 +29816,7 @@ class WebSocketConnectorFactory extends ConnectorFactory {
     }
     async _defaultWebSocketClient(url, subprotocols, headers) {
         try {
-            logger$m.debug('websocket_connector_connecting', { url, subprotocols });
+            logger$n.debug('websocket_connector_connecting', { url, subprotocols });
             if (typeof window !== 'undefined' &&
                 typeof window.WebSocket !== 'undefined') {
                 return await this._createBrowserWebSocket(url, subprotocols);
@@ -30119,7 +29899,7 @@ class WebSocketConnectorFactory extends ConnectorFactory {
                 await Promise.resolve().then(function () { return websocketConnectorNodeSsl; });
             }
             catch (error) {
-                logger$m.debug('ssl_certificate_loader_import_failed', {
+                logger$n.debug('ssl_certificate_loader_import_failed', {
                     error: error instanceof Error ? error.message : String(error),
                 });
             }
@@ -30128,7 +29908,7 @@ class WebSocketConnectorFactory extends ConnectorFactory {
         if (!loader) {
             return undefined;
         }
-        return await loader(logger$m);
+        return await loader(logger$n);
     }
 }
 
@@ -30463,7 +30243,7 @@ var atMostOnceDeliveryPolicyFactory = /*#__PURE__*/Object.freeze({
     default: AtMostOnceDeliveryPolicyFactory
 });
 
-const logger$l = getLogger('naylence.fame.delivery.delivery_profile_factory');
+const logger$m = getLogger('naylence.fame.delivery.delivery_profile_factory');
 const PROFILE_NAME_AT_LEAST_ONCE = 'at-least-once';
 const PROFILE_NAME_AT_MOST_ONCE = 'at-most-once';
 const ENV_VAR_FAME_DELIVERY_MAX_RETRIES = 'FAME_DELIVERY_MAX_RETRIES';
@@ -30503,7 +30283,7 @@ class DeliveryProfileFactory extends DeliveryPolicyFactory {
     async create(config) {
         const normalized = normalizeDeliveryProfileConfig(config);
         const profileConfig = resolveProfileConfig$1(normalized.profile);
-        logger$l.debug('enabling_delivery_profile', { profile: normalized.profile });
+        logger$m.debug('enabling_delivery_profile', { profile: normalized.profile });
         const policy = await DeliveryPolicyFactory.createDeliveryPolicy(profileConfig);
         if (!policy) {
             throw new Error(`Failed to create delivery policy for profile: ${normalized.profile}`);
@@ -30586,7 +30366,7 @@ function isSinkService(service) {
         service.capabilities.includes(core.SINK_CAPABILITY));
 }
 
-const logger$k = getLogger('naylence.fame.fabric.in_process');
+const logger$l = getLogger('naylence.fame.fabric.in_process');
 function normalizeNodeConfig(config) {
     if (config && typeof config === 'object' && !Array.isArray(config)) {
         return config;
@@ -30610,13 +30390,13 @@ class InProcessFameFabric extends core.FameFabric {
         this._versionLogged = true;
         const version = await resolveRuntimeVersion();
         if (version) {
-            logger$k.info('naylence_runtime_startup', {
+            logger$l.info('naylence_runtime_startup', {
                 version,
                 fabric_type: 'in_process',
             });
         }
         else {
-            logger$k.warning('naylence_runtime_version_not_found', {
+            logger$l.warning('naylence_runtime_version_not_found', {
                 message: 'Could not determine package version',
                 fabric_type: 'in_process',
             });
@@ -30641,7 +30421,7 @@ class InProcessFameFabric extends core.FameFabric {
             return;
         }
         await this.logStartupVersion();
-        logger$k.debug('starting_fabric', { type: 'in_process' });
+        logger$l.debug('starting_fabric', { type: 'in_process' });
         if (!this._currentNode) {
             const nodeConfig = normalizeNodeConfig(this._config?.node ?? null);
             this._currentNode = await NodeLikeFactory.createNode(nodeConfig);
@@ -30776,7 +30556,7 @@ var inProcessFameFabricFactory = /*#__PURE__*/Object.freeze({
     default: InProcessFameFabricFactory
 });
 
-const logger$j = getLogger('naylence.fame.node.admission.admission_profile_factory');
+const logger$k = getLogger('naylence.fame.node.admission.admission_profile_factory');
 const ENV_VAR_IS_ROOT = 'FAME_ROOT';
 const ENV_VAR_JWT_AUDIENCE = 'FAME_JWT_AUDIENCE';
 const ENV_VAR_ADMISSION_TOKEN_URL = 'FAME_ADMISSION_TOKEN_URL';
@@ -31011,7 +30791,7 @@ class AdmissionProfileFactory extends AdmissionClientFactory {
     async create(config) {
         const normalized = normalizeConfig$m(config);
         const profileConfig = resolveProfileConfig(normalized.profile);
-        logger$j.debug('enabling_admission_profile', { profile: normalized.profile });
+        logger$k.debug('enabling_admission_profile', { profile: normalized.profile });
         return AdmissionClientFactory.createAdmissionClient(profileConfig);
     }
 }
@@ -31050,7 +30830,7 @@ var admissionProfileFactory = /*#__PURE__*/Object.freeze({
     default: AdmissionProfileFactory
 });
 
-const logger$i = getLogger('naylence.fame.node.admission.direct_admission_client');
+const logger$j = getLogger('naylence.fame.node.admission.direct_admission_client');
 class DirectAdmissionClient {
     constructor(options) {
         this.hasUpstream = true;
@@ -31075,7 +30855,7 @@ class DirectAdmissionClient {
         }
     }
     async hello(systemId, instanceId, requestedLogicals) {
-        logger$i.debug('direct_admission_hello_start', {
+        logger$j.debug('direct_admission_hello_start', {
             providedSystemId: systemId,
             instanceId,
             requestedLogicals,
@@ -31083,7 +30863,7 @@ class DirectAdmissionClient {
         const effectiveSystemId = systemId && systemId.trim().length > 0
             ? systemId
             : await core.generateIdAsync({ mode: 'fingerprint' }).catch(async () => {
-                logger$i.debug('direct_admission_fingerprint_generation_failed', {
+                logger$j.debug('direct_admission_fingerprint_generation_failed', {
                     reason: 'falling back to random id',
                 });
                 return core.generateIdAsync({ mode: 'random' });
@@ -31105,7 +30885,7 @@ class DirectAdmissionClient {
         const envelope = core.createFameEnvelope({
             frame: welcomeFrame,
         });
-        logger$i.debug('direct_admission_hello_success', {
+        logger$j.debug('direct_admission_hello_success', {
             systemId: welcomeFrame.systemId,
             instanceId: welcomeFrame.instanceId,
             acceptedLogicals: welcomeFrame.acceptedLogicals,
@@ -31282,7 +31062,7 @@ var noAuthInjectionStrategyFactory = /*#__PURE__*/Object.freeze({
     default: NoAuthInjectionStrategyFactory
 });
 
-const logger$h = getLogger('naylence.fame.node.admission.welcome_service_client');
+const logger$i = getLogger('naylence.fame.node.admission.welcome_service_client');
 class WelcomeServiceClient {
     constructor(options) {
         this.hasUpstream = options.hasUpstream ?? options.has_upstream ?? false;
@@ -31331,7 +31111,7 @@ class WelcomeServiceClient {
                 'Content-Type': 'application/json',
                 ...authHeaders,
             };
-            logger$h.debug('welcome_service_hello_request', {
+            logger$i.debug('welcome_service_hello_request', {
                 url: this.url,
                 systemId,
                 instanceId,
@@ -31367,7 +31147,7 @@ class WelcomeServiceClient {
                 parsedEnvelope.frame.type !== 'NodeWelcome') {
                 throw new Error(`Unexpected frame type '${parsedEnvelope.frame?.type ?? 'unknown'}'`);
             }
-            logger$h.debug('welcome_service_hello_success', {
+            logger$i.debug('welcome_service_hello_success', {
                 systemId: parsedEnvelope.frame.systemId,
                 targetSystemId: parsedEnvelope.frame.targetSystemId,
                 assignedPath: parsedEnvelope.frame.assignedPath,
@@ -32503,7 +32283,7 @@ var noopTokenVerifierFactory = /*#__PURE__*/Object.freeze({
     default: NoopTokenVerifierFactory
 });
 
-const logger$g = getLogger('naylence.fame.security.auth.oauth2_authorizer_factory');
+const logger$h = getLogger('naylence.fame.security.auth.oauth2_authorizer_factory');
 let oauth2AuthorizerModulePromise = null;
 function getOAuth2AuthorizerModule() {
     if (!oauth2AuthorizerModulePromise) {
@@ -32530,12 +32310,12 @@ class OAuth2AuthorizerFactory extends AuthorizerFactory {
         if (normalized.tokenIssuerConfig) {
             try {
                 tokenIssuer = await TokenIssuerFactory.createTokenIssuer(normalized.tokenIssuerConfig);
-                logger$g.debug('token_issuer_created_for_reverse_auth', {
+                logger$h.debug('token_issuer_created_for_reverse_auth', {
                     issuer_type: normalized.tokenIssuerConfig.type,
                 });
             }
             catch (error) {
-                logger$g.warning('failed_to_create_token_issuer_for_reverse_auth', {
+                logger$h.warning('failed_to_create_token_issuer_for_reverse_auth', {
                     error: error instanceof Error ? error.message : String(error),
                     issuer_config: normalized.tokenIssuerConfig,
                 });
@@ -33488,7 +33268,7 @@ var sessionKeyCredentialProviderFactory = /*#__PURE__*/Object.freeze({
     normalizeSessionKeyConfig: normalizeSessionKeyConfig
 });
 
-const logger$f = getLogger('naylence.fame.security.default_security_manager_factory');
+const logger$g = getLogger('naylence.fame.security.default_security_manager_factory');
 function normalizeDefaultSecurityManagerConfig(config) {
     if (!config) {
         return null;
@@ -33656,7 +33436,7 @@ class DefaultSecurityManagerFactory extends SecurityManagerFactory {
             return await KeyStoreFactory.createKeyStore(value, createOptions ?? undefined);
         }
         catch (error) {
-            logger$f.error('failed_to_create_key_store_from_config', {
+            logger$g.error('failed_to_create_key_store_from_config', {
                 error: error instanceof Error ? error.message : String(error),
             });
             return null;
@@ -33692,7 +33472,7 @@ class DefaultSecurityManagerFactory extends SecurityManagerFactory {
                 return null;
             }
             const cryptoProvider = cryptoProviderOverride ?? null;
-            logger$f.debug('auto_create_envelope_signer', {
+            logger$g.debug('auto_create_envelope_signer', {
                 has_crypto_override: Boolean(cryptoProviderOverride),
                 override_constructor: cryptoProviderOverride
                     ? (cryptoProviderOverride.constructor?.name ?? 'unknown')
@@ -33713,7 +33493,7 @@ class DefaultSecurityManagerFactory extends SecurityManagerFactory {
             });
         }
         catch (error) {
-            logger$f.error('failed_to_auto_create_envelope_signer', {
+            logger$g.error('failed_to_auto_create_envelope_signer', {
                 error: error instanceof Error ? error.message : String(error),
                 exc_info: true,
             });
@@ -33748,7 +33528,7 @@ class DefaultSecurityManagerFactory extends SecurityManagerFactory {
             });
         }
         catch (error) {
-            logger$f.error('failed_to_auto_create_envelope_verifier', {
+            logger$g.error('failed_to_auto_create_envelope_verifier', {
                 error: error instanceof Error ? error.message : String(error),
                 exc_info: true,
             });
@@ -33760,7 +33540,7 @@ class DefaultSecurityManagerFactory extends SecurityManagerFactory {
         if (encryptionConfig &&
             DefaultSecurityManagerFactory.isConfigLike(encryptionConfig)) {
             if (!keyManager) {
-                logger$f.warning('encryption_manager_config_requires_key_manager');
+                logger$g.warning('encryption_manager_config_requires_key_manager');
                 return { encryptionManager: null, secureChannelManager };
             }
             const manager = await EncryptionManagerFactory.createEncryptionManager(encryptionConfig, {
@@ -33797,7 +33577,7 @@ class DefaultSecurityManagerFactory extends SecurityManagerFactory {
             return { encryptionManager: manager, secureChannelManager };
         }
         catch (error) {
-            logger$f.error('failed_to_auto_create_encryption_manager', {
+            logger$g.error('failed_to_auto_create_encryption_manager', {
                 error: error instanceof Error ? error.message : String(error),
                 exc_info: true,
             });
@@ -33840,7 +33620,7 @@ class DefaultSecurityManagerFactory extends SecurityManagerFactory {
             });
         }
         catch (error) {
-            logger$f.error('failed_to_auto_create_key_manager', {
+            logger$g.error('failed_to_auto_create_key_manager', {
                 error: error instanceof Error ? error.message : String(error),
                 exc_info: true,
             });
@@ -33889,7 +33669,7 @@ class DefaultSecurityManagerFactory extends SecurityManagerFactory {
             })) ?? null);
         }
         catch (error) {
-            logger$f.error('failed_to_auto_create_authorizer', {
+            logger$g.error('failed_to_auto_create_authorizer', {
                 error: error instanceof Error ? error.message : String(error),
                 exc_info: true,
             });
@@ -33918,7 +33698,7 @@ class DefaultSecurityManagerFactory extends SecurityManagerFactory {
             });
         }
         catch (error) {
-            logger$f.error('failed_to_auto_create_certificate_manager', {
+            logger$g.error('failed_to_auto_create_certificate_manager', {
                 error: error instanceof Error ? error.message : String(error),
                 exc_info: true,
             });
@@ -34176,7 +33956,7 @@ var defaultKeyManagerFactory = /*#__PURE__*/Object.freeze({
     default: DefaultKeyManagerFactory
 });
 
-const logger$e = getLogger('naylence.fame.security.keys.in_memory_key_store');
+const logger$f = getLogger('naylence.fame.security.keys.in_memory_key_store');
 class InMemoryKeyStore extends KeyStore {
     constructor(initialKeys = null) {
         super();
@@ -34198,7 +33978,7 @@ class InMemoryKeyStore extends KeyStore {
         }
         catch (error) {
             if (error instanceof JWKValidationError) {
-                logger$e.warning('rejected_invalid_jwk_individual', {
+                logger$f.warning('rejected_invalid_jwk_individual', {
                     kid,
                     error: error.message,
                 });
@@ -34242,7 +34022,7 @@ class InMemoryKeyStore extends KeyStore {
                 }
             }
             if (staleKeys.length > 0) {
-                logger$e.debug('removing_stale_keys_before_adding_new_key', {
+                logger$f.debug('removing_stale_keys_before_adding_new_key', {
                     new_kid: kid,
                     physical_path: physicalPath,
                     base_path: basePath,
@@ -34270,7 +34050,7 @@ class InMemoryKeyStore extends KeyStore {
                 }
                 keysByPath[path].push(existingKid);
             }
-            logger$e.debug('key_lookup_failed', {
+            logger$f.debug('key_lookup_failed', {
                 missing_kid: kid,
                 available_kids: Array.from(this.keys.keys()),
                 keys_by_path: keysByPath,
@@ -34319,7 +34099,7 @@ class InMemoryKeyStore extends KeyStore {
             this.keys.delete(kid);
         }
         if (keysToRemove.length > 0) {
-            logger$e.debug('removed_keys_for_path', {
+            logger$f.debug('removed_keys_for_path', {
                 physical_path: physicalPath,
                 removed_key_ids: keysToRemove,
                 count: keysToRemove.length,
@@ -34330,7 +34110,7 @@ class InMemoryKeyStore extends KeyStore {
     async removeKey(kid) {
         const removed = this.keys.delete(kid);
         if (removed) {
-            logger$e.debug('removed_individual_key', { kid });
+            logger$f.debug('removed_individual_key', { kid });
         }
         return removed;
     }
@@ -34696,7 +34476,7 @@ var capabilityAwareRoutingPolicyFactory = /*#__PURE__*/Object.freeze({
     default: CapabilityAwareRoutingPolicyFactory
 });
 
-const logger$d = getLogger('naylence.fame.sentinel.composite_routing_policy_factory');
+const logger$e = getLogger('naylence.fame.sentinel.composite_routing_policy_factory');
 const FACTORY_META$8 = {
     base: ROUTING_POLICY_FACTORY_BASE,
     key: 'CompositeRoutingPolicy',
@@ -34722,13 +34502,13 @@ class CompositeRoutingPolicyFactory extends RoutingPolicyFactory {
                     policies.push(policy);
                 }
                 else {
-                    logger$d.warning('composite_policy_null_child', {
+                    logger$e.warning('composite_policy_null_child', {
                         config: policyConfig,
                     });
                 }
             }
             catch (error) {
-                logger$d.warning('composite_policy_child_error', {
+                logger$e.warning('composite_policy_child_error', {
                     error: error instanceof Error ? error.message : String(error),
                     config: policyConfig,
                 });
@@ -35024,7 +34804,7 @@ var hrwLoadBalancingStrategyFactory = /*#__PURE__*/Object.freeze({
     default: HRWLoadBalancingStrategyFactory
 });
 
-const logger$c = getLogger('naylence.fame.sentinel.load_balancing.load_balancing_profile_factory');
+const logger$d = getLogger('naylence.fame.sentinel.load_balancing.load_balancing_profile_factory');
 const PROFILE_NAME_RANDOM = 'random';
 const PROFILE_NAME_ROUND_ROBIN = 'round_robin';
 const PROFILE_NAME_HRW = 'hrw';
@@ -35058,7 +34838,7 @@ class LoadBalancingProfileFactory extends LoadBalancingStrategyFactory {
     async create(config, ...factoryArgs) {
         const finalConfig = this.normalizeConfig(config);
         const profileName = finalConfig.profile ?? PROFILE_NAME_DEVELOPMENT$1;
-        logger$c.debug('enabling_load_balancing_profile', { profile: profileName });
+        logger$d.debug('enabling_load_balancing_profile', { profile: profileName });
         const strategyConfig = this.resolveProfile(profileName);
         const strategy = await factory.createResource(LOAD_BALANCING_STRATEGY_FACTORY_BASE, strategyConfig, { factoryArgs });
         if (!strategy) {
@@ -35249,7 +35029,7 @@ var stickyLoadBalancingStrategyFactory = /*#__PURE__*/Object.freeze({
     default: StickyLoadBalancingStrategyFactory
 });
 
-const logger$b = getLogger('naylence.fame.sentinel.routing_profile_factory');
+const logger$c = getLogger('naylence.fame.sentinel.routing_profile_factory');
 const PROFILE_NAME_DEVELOPMENT = 'development';
 const PROFILE_NAME_PRODUCTION = 'production';
 const PROFILE_NAME_BASIC = 'basic';
@@ -35300,7 +35080,7 @@ class RoutingProfileFactory extends RoutingPolicyFactory {
     }
     async create(config, ...kwargs) {
         const normalized = this.normalizeConfig(config);
-        logger$b.debug('enabling_routing_profile', { profile: normalized.profile });
+        logger$c.debug('enabling_routing_profile', { profile: normalized.profile });
         const routingConfig = this.getProfileConfig(normalized.profile);
         const policy = await factory.createResource(ROUTING_POLICY_FACTORY_BASE, routingConfig, {
             factoryArgs: kwargs,
@@ -35596,21 +35376,21 @@ class OpenTelemetryTraceEmitter extends BaseTraceEmitter {
 }
 function normalizeOpenTelemetryTraceEmitterOptions(input) {
     const source = (input ?? {});
-    const serviceName = extractNonEmptyString(pickFirst(source, ['serviceName', 'service_name'])) ?? 'naylence-service';
-    const tracer = pickFirst(source, ['tracer']);
-    const otelApi = pickFirst(source, [
+    const serviceName = extractNonEmptyString$1(pickFirst$1(source, ['serviceName', 'service_name'])) ?? 'naylence-service';
+    const tracer = pickFirst$1(source, ['tracer']);
+    const otelApi = pickFirst$1(source, [
         'otelApi',
         'otel_api',
     ]);
     if (!otelApi) {
         throw new Error('OpenTelemetryTraceEmitter requires OpenTelemetry API bindings. Provide otelApi via options.');
     }
-    const lifecycle = pickFirst(source, [
+    const lifecycle = pickFirst$1(source, [
         'lifecycle',
         'lifeCycle',
         'life_cycle',
     ]) ?? null;
-    const authStrategy = pickFirst(source, [
+    const authStrategy = pickFirst$1(source, [
         'authStrategy',
         'auth_strategy',
     ]) ?? null;
@@ -35622,7 +35402,7 @@ function normalizeOpenTelemetryTraceEmitterOptions(input) {
         authStrategy,
     };
 }
-function pickFirst(source, keys) {
+function pickFirst$1(source, keys) {
     for (const key of keys) {
         if (Object.prototype.hasOwnProperty.call(source, key)) {
             const value = source[key];
@@ -35633,7 +35413,7 @@ function pickFirst(source, keys) {
     }
     return undefined;
 }
-function extractNonEmptyString(value) {
+function extractNonEmptyString$1(value) {
     if (typeof value === 'string') {
         const trimmed = value.trim();
         if (trimmed.length > 0) {
@@ -35686,6 +35466,241 @@ var openTelemetryTraceEmitter = /*#__PURE__*/Object.freeze({
     OpenTelemetryTraceEmitter: OpenTelemetryTraceEmitter
 });
 
+const logger$b = getLogger('naylence.fame.telemetry.otel_setup');
+const stringFrom = (...codes) => String.fromCharCode(...codes);
+const OTEL_PREFIX = `${stringFrom(64, 111, 112, 101, 110, 116, 101, 108, 101, 109, 101, 116, 114, 121)}${stringFrom(47)}`;
+const OTEL_API_SPEC = `${OTEL_PREFIX}${stringFrom(97, 112, 105)}`;
+const OTEL_RESOURCES_SPEC = `${OTEL_PREFIX}${stringFrom(114, 101, 115, 111, 117, 114, 99, 101, 115)}`;
+const OTEL_TRACE_NODE_SPEC = `${OTEL_PREFIX}${stringFrom(115, 100, 107, 45, 116, 114, 97, 99, 101, 45, 110, 111, 100, 101)}`;
+const OTEL_TRACE_BASE_SPEC = `${OTEL_PREFIX}${stringFrom(115, 100, 107, 45, 116, 114, 97, 99, 101, 45, 98, 97, 115, 101)}`;
+const OTEL_EXPORTER_HTTP_SPEC = `${OTEL_PREFIX}${stringFrom(101, 120, 112, 111, 114, 116, 101, 114, 45, 116, 114, 97, 99, 101, 45, 111, 116, 108, 112, 45, 104, 116, 116, 112)}`;
+let registeredOtel = null;
+async function setupOtel(options) {
+    const normalized = normalizeSetupOtelOptions(options);
+    try {
+        if (registeredOtel) {
+            logger$b.debug('open_telemetry_reusing_provider', {
+                service_name: normalized.serviceName,
+            });
+            return registeredOtel.control;
+        }
+        const [apiModule, resourcesModule, nodeModule, traceBaseModule] = await Promise.all([
+            import(OTEL_API_SPEC),
+            import(OTEL_RESOURCES_SPEC),
+            import(OTEL_TRACE_NODE_SPEC),
+            import(OTEL_TRACE_BASE_SPEC),
+        ]);
+        const { trace } = apiModule;
+        const { defaultResource, resourceFromAttributes } = resourcesModule;
+        const { NodeTracerProvider } = nodeModule;
+        const { BatchSpanProcessor, ConsoleSpanExporter, ParentBasedSampler, AlwaysOnSampler, AlwaysOffSampler, TraceIdRatioBasedSampler, } = traceBaseModule;
+        const currentProvider = trace.getTracerProvider();
+        if (currentProvider && currentProvider instanceof NodeTracerProvider) {
+            return null;
+        }
+        if (currentProvider &&
+            currentProvider.constructor?.name === 'NodeTracerProvider') {
+            logger$b.debug('open_telemetry_existing_node_provider', {
+                service_name: normalized.serviceName,
+            });
+            return null;
+        }
+        logger$b.debug('open_telemetry_initializing', {
+            service_name: normalized.serviceName,
+            endpoint: normalized.endpoint ?? null,
+            environment: normalized.environment ?? null,
+            sampler: normalized.sampler ?? null,
+            headers_present: Boolean(normalized.headers && Object.keys(normalized.headers).length),
+        });
+        const sampler = resolveSampler(normalized.sampler, {
+            ParentBasedSampler,
+            AlwaysOnSampler,
+            AlwaysOffSampler,
+            TraceIdRatioBasedSampler,
+        });
+        const baseResource = defaultResource();
+        const mergedResource = resourceFromAttributes({
+            'service.name': normalized.serviceName,
+            'service.instance.id': generateInstanceId(),
+            'deployment.environment': normalized.environment ?? 'dev',
+        });
+        const resource = baseResource.merge(mergedResource);
+        const exporter = await resolveExporter(normalized.endpoint ?? undefined, normalized.headers, ConsoleSpanExporter);
+        const spanProcessor = new BatchSpanProcessor(exporter);
+        const provider = new NodeTracerProvider({
+            resource,
+            sampler,
+            spanProcessors: [spanProcessor],
+        });
+        provider.register();
+        logger$b.debug('open_telemetry_initialized', {
+            service_name: normalized.serviceName,
+            exporter: exporter.constructor?.name ?? 'unknown_exporter',
+        });
+        const control = {
+            forceFlush: async () => {
+                try {
+                    await provider.forceFlush();
+                }
+                catch (flushError) {
+                    logger$b.warning('open_telemetry_force_flush_failed', {
+                        error: flushError instanceof Error
+                            ? flushError.message
+                            : String(flushError),
+                    });
+                }
+            },
+            shutdown: async () => {
+                try {
+                    await provider.shutdown();
+                }
+                catch (shutdownError) {
+                    logger$b.warning('open_telemetry_shutdown_failed', {
+                        error: shutdownError instanceof Error
+                            ? shutdownError.message
+                            : String(shutdownError),
+                    });
+                }
+                finally {
+                    registeredOtel = null;
+                }
+            },
+        };
+        registeredOtel = {
+            provider,
+            control,
+        };
+        return control;
+    }
+    catch (error) {
+        logger$b.error('open_telemetry_not_available', {
+            error: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error && error.stack ? error.stack : undefined,
+        });
+        return null;
+    }
+}
+function normalizeSetupOtelOptions(options) {
+    const source = (options ?? {});
+    const serviceName = extractNonEmptyString(pickFirst(source, ['serviceName', 'service_name'])) ??
+        'naylence-service';
+    const endpoint = extractNonEmptyString(pickFirst(source, ['endpoint', 'otlpEndpoint', 'otlp_endpoint'])) ?? null;
+    const environment = extractNonEmptyString(pickFirst(source, [
+        'environment',
+        'deploymentEnvironment',
+        'deployment_environment',
+    ])) ?? null;
+    const sampler = extractNonEmptyString(pickFirst(source, ['sampler', 'samplingStrategy', 'sampling_strategy'])) ?? null;
+    const headers = extractHeaders(pickFirst(source, ['headers', 'otlpHeaders', 'otlp_headers']));
+    return {
+        serviceName,
+        endpoint,
+        environment,
+        sampler,
+        headers: headers ?? undefined,
+    };
+}
+function pickFirst(source, keys) {
+    for (const key of keys) {
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+            const value = source[key];
+            if (value !== undefined) {
+                return value;
+            }
+        }
+    }
+    return undefined;
+}
+function extractNonEmptyString(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (trimmed.length > 0) {
+            return trimmed;
+        }
+    }
+    return undefined;
+}
+function extractHeaders(value) {
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    const headers = {};
+    for (const [key, raw] of Object.entries(value)) {
+        if (typeof raw === 'string') {
+            headers[key] = raw;
+        }
+    }
+    return Object.keys(headers).length > 0 ? headers : null;
+}
+function generateInstanceId() {
+    try {
+        if (typeof crypto !== 'undefined' &&
+            typeof crypto.randomUUID === 'function') {
+            return crypto.randomUUID().replace(/-/g, '');
+        }
+    }
+    catch {
+        // Ignore crypto availability errors
+    }
+    const random = Math.random().toString(16).slice(2);
+    return random.padEnd(32, '0').slice(0, 32);
+}
+function resolveSampler(samplerSetting, samplers) {
+    const normalized = (samplerSetting ?? 'parentbased_always_on').toLowerCase();
+    let base;
+    if (normalized === 'always_off') {
+        base = new samplers.AlwaysOffSampler();
+    }
+    else if (normalized === 'always_on' ||
+        normalized === 'parentbased_always_on') {
+        base = new samplers.AlwaysOnSampler();
+    }
+    else if (normalized.startsWith('ratio:')) {
+        const ratioValue = Number.parseFloat(normalized.slice('ratio:'.length));
+        const ratio = Number.isFinite(ratioValue)
+            ? Math.min(Math.max(ratioValue, 0), 1)
+            : 1;
+        base = new samplers.TraceIdRatioBasedSampler(ratio);
+    }
+    else {
+        base = new samplers.AlwaysOnSampler();
+    }
+    return new samplers.ParentBasedSampler({ root: base });
+}
+async function resolveExporter(endpoint, headers, ConsoleSpanExporter) {
+    if (endpoint) {
+        try {
+            const exporterModule = await import(OTEL_EXPORTER_HTTP_SPEC);
+            if ('OTLPTraceExporter' in exporterModule) {
+                const { OTLPTraceExporter } = exporterModule;
+                const exporterOptions = {
+                    url: endpoint,
+                };
+                if (headers && Object.keys(headers).length > 0) {
+                    exporterOptions.headers = headers;
+                }
+                logger$b.debug('open_telemetry_using_otlp_http_exporter', {
+                    endpoint,
+                    headers_present: Boolean(headers && Object.keys(headers).length),
+                });
+                return new OTLPTraceExporter(exporterOptions);
+            }
+        }
+        catch (error) {
+            logger$b.error('open_telemetry_exporter_not_available', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    logger$b.warning('open_telemetry_falling_back_to_console_exporter');
+    return new ConsoleSpanExporter();
+}
+
+var otelSetup = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    setupOtel: setupOtel
+});
+
 /**
  * Abstract base class for transport listeners.
  *