@foam-ai/node-cliengo 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/node-cliengo/src/constants.d.ts

@@ -8,8 +8,7 @@
  *   through individual files.
  *
  * Edge cases covered:
- *   - FOAM_OTEL_ENDPOINT is hardcoded (not read from env) to prevent
- *     misconfiguration; services override via `options.endpoint` only.
+ *   - FOAM_OTEL_ENDPOINT is hardcoded — not configurable via env or options.
  *   - REDACTED_KEYS uses lowercase comparison so "Authorization", "PASSWORD",
  *     "Token" all match. Includes both "creditcard" and "credit_card" variants.
  *   - HEALTH_ROUTES covers the four most common patterns across all 5 Cliengo

package/dist/node-cliengo/src/constants.js

@@ -9,8 +9,7 @@
  *   through individual files.
  *
  * Edge cases covered:
- *   - FOAM_OTEL_ENDPOINT is hardcoded (not read from env) to prevent
- *     misconfiguration; services override via `options.endpoint` only.
+ *   - FOAM_OTEL_ENDPOINT is hardcoded — not configurable via env or options.
  *   - REDACTED_KEYS uses lowercase comparison so "Authorization", "PASSWORD",
  *     "Token" all match. Includes both "creditcard" and "credit_card" variants.
  *   - HEALTH_ROUTES covers the four most common patterns across all 5 Cliengo
@@ -31,6 +30,10 @@ exports.REDACTED_KEYS = new Set([
     'secret',
     'creditcard',
     'credit_card',
+    'api_key',
+    'apikey',
+    'access_token',
+    'accesstoken',
 ]);
 exports.HEALTH_ROUTES = new Set(['/health', '/healthz', '/ready', '/status']);
 exports.REQUEST_CONTEXT_FIELDS = [

package/dist/node-cliengo/src/http/express.d.ts

@@ -36,6 +36,27 @@
 import { type Tracer } from '@opentelemetry/api';
 import type { ExpressErrorHandler, ExpressRequestHandler } from '../types';
 export declare function createExpressMiddleware(tracer: Tracer): ExpressRequestHandler;
+/**
+ * Reads the trace context that was captured on the request at middleware time.
+ * Use this in pino-http's `customProps` to get trace IDs even after NR's
+ * transaction has ended:
+ *
+ *   pinoHttp({ customProps: (req) => getRequestTraceContext(req) })
+ */
+export declare function getRequestTraceContext(req: any): {
+    traceId: string;
+    spanId: string;
+    traceparent: string;
+};
+/**
+ * Returns pino-http options with customProps pre-wired to read the trace
+ * context stored on req by createExpressMiddleware(). Zero config for services:
+ *
+ *   app.use(pinoHttp({ logger, ...foam.createPinoHttpOptions() }));
+ */
+export declare function createPinoHttpOptions(): {
+    customProps: (req: any) => Record<string, string>;
+};
 export declare function createExpressErrorHandler(middlewareRef?: ExpressRequestHandler & {
     _markErrorHandler?: () => void;
 }): ExpressErrorHandler;

package/dist/node-cliengo/src/http/express.js

@@ -36,11 +36,15 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createExpressMiddleware = createExpressMiddleware;
+exports.getRequestTraceContext = getRequestTraceContext;
+exports.createPinoHttpOptions = createPinoHttpOptions;
 exports.createExpressErrorHandler = createExpressErrorHandler;
 const api_1 = require("@opentelemetry/api");
 const trace_bridge_1 = require("../trace-bridge");
 const request_context_1 = require("./request-context");
 const SPAN_KEY = Symbol.for('foam.shadow.span');
+const TRACE_CTX_KEY = Symbol.for('foam.trace.context');
+const ERROR_RECORDED_KEY = Symbol.for('foam.shadow.errorRecorded');
 /* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment */
 function createExpressMiddleware(tracer) {
     let errorHandlerRegistered = false;
@@ -52,15 +56,35 @@ function createExpressMiddleware(tracer) {
         const method = req.method ?? 'UNKNOWN';
         const target = req.originalUrl ?? req.url ?? '/';
         const { traceId, spanId } = (0, trace_bridge_1.getTraceContext)();
+        // Build a parent context so the shadow span shares the same OTel traceId
+        // as NR's transaction (or the active OTel span). Without this, startSpan()
+        // creates a root span with a separate traceId, breaking end-to-end
+        // traceability between HTTP spans, consumer spans, and logs.
+        let parentCtx;
+        if (traceId && spanId) {
+            parentCtx = api_1.trace.setSpanContext(api_1.ROOT_CONTEXT, {
+                traceId,
+                spanId,
+                traceFlags: 1,
+                isRemote: true,
+            });
+        }
         const span = tracer.startSpan(`${method} ${target}`, {
             attributes: {
                 'http.method': method,
                 'http.target': target,
-                ...(traceId ? { 'nr.traceId': traceId } : {}),
-                ...(spanId ? { 'nr.spanId': spanId } : {}),
             },
-        });
+        }, parentCtx);
         req[SPAN_KEY] = span;
+        // Read trace context from the span we just created — not from NR.
+        // The span's spanContext() always has the correct traceId, whether it
+        // inherited from NR or generated a fresh root.
+        const sc = span.spanContext();
+        req[TRACE_CTX_KEY] = {
+            traceId: sc.traceId,
+            spanId: sc.spanId,
+            traceparent: `00-${sc.traceId}-${sc.spanId}-01`,
+        };
         const startTime = Date.now();
         const onFinish = () => {
             try {
@@ -71,7 +95,10 @@ function createExpressMiddleware(tracer) {
                 span.setAttribute('http.route', route);
                 span.setAttribute('http.response_content_length', String(contentLength));
                 span.setAttribute('http.duration_ms', Date.now() - startTime);
-                if (statusCode >= 500) {
+                if (req[ERROR_RECORDED_KEY]) {
+                    // Error handler already set status — don't overwrite
+                }
+                else if (statusCode >= 500) {
                     span.setStatus({ code: api_1.SpanStatusCode.ERROR });
                     if (!errorHandlerRegistered && !warnedMissingErrorHandler) {
                         warnedMissingErrorHandler = true;
@@ -94,11 +121,47 @@ function createExpressMiddleware(tracer) {
             }
         };
         res.on('finish', onFinish);
-        next();
+        // Set the shadow span as the active context for the duration of the
+        // request. This makes it discoverable via trace.getActiveSpan() so
+        // buildTraceparent() (used by injectJobData/injectSnsAttributes) returns
+        // the same traceId — even without NR.
+        const activeCtx = api_1.trace.setSpan(parentCtx ?? api_1.ROOT_CONTEXT, span);
+        api_1.context.with(activeCtx, () => next());
     };
     middleware._markErrorHandler = markErrorHandlerRegistered;
     return middleware;
 }
+/**
+ * Reads the trace context that was captured on the request at middleware time.
+ * Use this in pino-http's `customProps` to get trace IDs even after NR's
+ * transaction has ended:
+ *
+ *   pinoHttp({ customProps: (req) => getRequestTraceContext(req) })
+ */
+function getRequestTraceContext(req) {
+    try {
+        const ctx = req[TRACE_CTX_KEY];
+        return {
+            traceId: ctx?.traceId ?? '',
+            spanId: ctx?.spanId ?? '',
+            traceparent: ctx?.traceparent ?? '',
+        };
+    }
+    catch {
+        return { traceId: '', spanId: '', traceparent: '' };
+    }
+}
+/**
+ * Returns pino-http options with customProps pre-wired to read the trace
+ * context stored on req by createExpressMiddleware(). Zero config for services:
+ *
+ *   app.use(pinoHttp({ logger, ...foam.createPinoHttpOptions() }));
+ */
+function createPinoHttpOptions() {
+    return {
+        customProps: (req) => getRequestTraceContext(req),
+    };
+}
 function createExpressErrorHandler(middlewareRef) {
     middlewareRef?._markErrorHandler?.();
     return (err, req, _res, next) => {
@@ -112,6 +175,7 @@ function createExpressErrorHandler(middlewareRef) {
                     stack: error.stack,
                 });
                 span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: error.message });
+                req[ERROR_RECORDED_KEY] = true;
             }
         }
         catch {

package/dist/node-cliengo/src/http/fastify.d.ts

@@ -5,7 +5,8 @@
  * Why this file exists:
  *   Same rationale as the Express middleware (see express.ts). Fastify's hook
  *   system is different — we use three hooks instead of middleware + error handler:
- *   - onRequest: creates the shadow span, reads NR's traceId
+ *   - onRequest: creates the shadow span, reads NR's traceId, sets the span as
+ *     the active OTel context so route handlers inherit it via AsyncLocalStorage
  *   - onError: records exception details (fires BEFORE errorHandler, so we see
  *     every error including ones mapped to non-500 responses like AppError.badRequest)
  *   - onResponse: records status/route/duration, captures request context, ends span
@@ -15,14 +16,27 @@
  * Edge cases covered:
  *   - Fastify's onError fires for ALL errors including 4xx AppError variants.
  *     We record the exception on the span regardless — Foam sees the full error
- *     even for 400s. The span status is only set to ERROR by onError (not
- *     overwritten to OK by onResponse for <500 codes, since onError already set it).
+ *     even for 400s. Once onError sets ERROR status, onResponse never overwrites it.
  *   - request.routeOptions?.url may not exist in older Fastify versions — falls
  *     back to request.url.
  *   - Health routes skipped for request.context capture (same as Express).
  *   - All hooks wrapped in try/catch — never crashes the request pipeline.
- *   - done() always called even if our code throws — Fastify hook contract.
+ *   - onError/onResponse use async hooks (Fastify 5 forward-compat).
+ *     onRequest uses callback style intentionally for context.with() propagation.
+ *   - Plugin sets Symbol.for('skip-override') (same as fastify-plugin) so hooks
+ *     fire globally across all encapsulated contexts. Without this, hooks only
+ *     fire for routes in the same plugin scope — a silent production footgun.
  */
 import { type Tracer } from '@opentelemetry/api';
 import type { FastifyPluginAsync } from '../types';
+/**
+ * Reads the trace context that was captured on the request at hook time.
+ * Use this in Fastify's logger mixin or serializers to get trace IDs even
+ * after NR's transaction has ended.
+ */
+export declare function getRequestTraceContext(request: any): {
+    traceId: string;
+    spanId: string;
+    traceparent: string;
+};
 export declare function createFastifyPlugin(tracer: Tracer): FastifyPluginAsync;

package/dist/node-cliengo/src/http/fastify.js

@@ -6,7 +6,8 @@
  * Why this file exists:
  *   Same rationale as the Express middleware (see express.ts). Fastify's hook
  *   system is different — we use three hooks instead of middleware + error handler:
- *   - onRequest: creates the shadow span, reads NR's traceId
+ *   - onRequest: creates the shadow span, reads NR's traceId, sets the span as
+ *     the active OTel context so route handlers inherit it via AsyncLocalStorage
  *   - onError: records exception details (fires BEFORE errorHandler, so we see
  *     every error including ones mapped to non-500 responses like AppError.badRequest)
  *   - onResponse: records status/route/duration, captures request context, ends span
@@ -16,46 +17,90 @@
  * Edge cases covered:
  *   - Fastify's onError fires for ALL errors including 4xx AppError variants.
  *     We record the exception on the span regardless — Foam sees the full error
- *     even for 400s. The span status is only set to ERROR by onError (not
- *     overwritten to OK by onResponse for <500 codes, since onError already set it).
+ *     even for 400s. Once onError sets ERROR status, onResponse never overwrites it.
  *   - request.routeOptions?.url may not exist in older Fastify versions — falls
  *     back to request.url.
  *   - Health routes skipped for request.context capture (same as Express).
  *   - All hooks wrapped in try/catch — never crashes the request pipeline.
- *   - done() always called even if our code throws — Fastify hook contract.
+ *   - onError/onResponse use async hooks (Fastify 5 forward-compat).
+ *     onRequest uses callback style intentionally for context.with() propagation.
+ *   - Plugin sets Symbol.for('skip-override') (same as fastify-plugin) so hooks
+ *     fire globally across all encapsulated contexts. Without this, hooks only
+ *     fire for routes in the same plugin scope — a silent production footgun.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRequestTraceContext = getRequestTraceContext;
 exports.createFastifyPlugin = createFastifyPlugin;
 const api_1 = require("@opentelemetry/api");
 const trace_bridge_1 = require("../trace-bridge");
 const request_context_1 = require("./request-context");
 const SPAN_KEY = Symbol.for('foam.shadow.span');
 const START_KEY = Symbol.for('foam.shadow.start');
+const TRACE_CTX_KEY = Symbol.for('foam.trace.context');
+const ERROR_RECORDED_KEY = Symbol.for('foam.shadow.errorRecorded');
+/**
+ * Reads the trace context that was captured on the request at hook time.
+ * Use this in Fastify's logger mixin or serializers to get trace IDs even
+ * after NR's transaction has ended.
+ */
+function getRequestTraceContext(request) {
+    try {
+        const ctx = request[TRACE_CTX_KEY];
+        return {
+            traceId: ctx?.traceId ?? '',
+            spanId: ctx?.spanId ?? '',
+            traceparent: ctx?.traceparent ?? '',
+        };
+    }
+    catch {
+        return { traceId: '', spanId: '', traceparent: '' };
+    }
+}
 /* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment */
 function createFastifyPlugin(tracer) {
-    return async (fastify) => {
+    const plugin = async (fastify) => {
+        // onRequest uses callback style intentionally — otelContext.with(ctx, done)
+        // propagates the shadow span as the active OTel context via AsyncLocalStorage
+        // to all downstream hooks and the route handler. Async hooks would lose the
+        // context after the awaited promise resolves.
         fastify.addHook('onRequest', (request, _reply, done) => {
             try {
                 const method = request.method ?? 'UNKNOWN';
                 const url = request.url ?? '/';
                 const { traceId, spanId } = (0, trace_bridge_1.getTraceContext)();
+                let parentCtx;
+                if (traceId && spanId) {
+                    parentCtx = api_1.trace.setSpanContext(api_1.ROOT_CONTEXT, {
+                        traceId,
+                        spanId,
+                        traceFlags: 1,
+                        isRemote: true,
+                    });
+                }
                 const span = tracer.startSpan(`${method} ${url}`, {
                     attributes: {
                         'http.method': method,
                         'http.target': url,
-                        ...(traceId ? { 'nr.traceId': traceId } : {}),
-                        ...(spanId ? { 'nr.spanId': spanId } : {}),
                     },
-                });
+                }, parentCtx);
                 request[SPAN_KEY] = span;
                 request[START_KEY] = Date.now();
+                const sc = span.spanContext();
+                request[TRACE_CTX_KEY] = {
+                    traceId: sc.traceId,
+                    spanId: sc.spanId,
+                    traceparent: `00-${sc.traceId}-${sc.spanId}-01`,
+                };
+                const activeCtx = api_1.trace.setSpan(parentCtx ?? api_1.ROOT_CONTEXT, span);
+                api_1.context.with(activeCtx, () => done());
+                return;
             }
             catch {
                 /* never crash */
             }
             done();
         });
-        fastify.addHook('onError', (request, _reply, error, done) => {
+        fastify.addHook('onError', async (request, _reply, error) => {
             try {
                 const span = request[SPAN_KEY];
                 if (span) {
@@ -65,14 +110,14 @@ function createFastifyPlugin(tracer) {
                         stack: error.stack,
                     });
                     span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: error.message });
+                    request[ERROR_RECORDED_KEY] = true;
                 }
             }
             catch {
                 /* never crash */
             }
-            done();
         });
-        fastify.addHook('onResponse', (request, reply, done) => {
+        fastify.addHook('onResponse', async (request, reply) => {
             try {
                 const span = request[SPAN_KEY];
                 if (span) {
@@ -82,8 +127,13 @@ function createFastifyPlugin(tracer) {
                     span.setAttribute('http.status_code', statusCode);
                     span.setAttribute('http.route', route);
                     span.setAttribute('http.duration_ms', Date.now() - start);
-                    if (statusCode < 500) {
-                        span.setStatus({ code: api_1.SpanStatusCode.OK });
+                    if (!request[ERROR_RECORDED_KEY]) {
+                        if (statusCode >= 500) {
+                            span.setStatus({ code: api_1.SpanStatusCode.ERROR });
+                        }
+                        else {
+                            span.setStatus({ code: api_1.SpanStatusCode.OK });
+                        }
                     }
                     if (!(0, request_context_1.isHealthRoute)(route) && !(0, request_context_1.isHealthRoute)(request.url ?? '/')) {
                         (0, request_context_1.captureRequestContext)(span, request);
@@ -94,8 +144,13 @@ function createFastifyPlugin(tracer) {
             catch {
                 /* never crash */
             }
-            done();
         });
     };
+    // Equivalent to wrapping with fastify-plugin — breaks Fastify's encapsulation
+    // so hooks fire for ALL routes, not just those registered in the same scope.
+    // Without this, hooks silently no-op for routes in child contexts.
+    plugin[Symbol.for('skip-override')] = true;
+    plugin[Symbol.for('fastify.display-name')] = '@foam-ai/node-cliengo';
+    return plugin;
 }
 /* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment */

package/dist/node-cliengo/src/index.d.ts

@@ -11,16 +11,19 @@
  *
  *   The individual function exports exist for tree-shaking and for cases where
  *   a service needs to call e.g. injectJobData() from a file that doesn't have
- *   access to the foam instance.
+ *   access to the foam instance. createFastifyPlugin is NOT exported standalone
+ *   because the raw function takes a tracer argument — use foam.createFastifyPlugin()
+ *   instead.
  */
-export { init } from './init';
+export { init, getFoam, createFastifyLoggerConfig } from './init';
 export { buildTraceparent, extractParentContext, getTraceContext } from './trace-bridge';
 export { injectSnsAttributes } from './sns';
 export { injectJobData, wrapJobConsumer } from './job';
 export { wrapSqsConsumer } from './sqs';
-export { createExpressMiddleware, createExpressErrorHandler } from './http/express';
-export { createFastifyPlugin } from './http/fastify';
+export { createExpressMiddleware, createExpressErrorHandler, getRequestTraceContext, createPinoHttpOptions } from './http/express';
+export { getRequestTraceContext as getFastifyRequestTraceContext } from './http/fastify';
 export { createWinstonFormat } from './logs/winston-format';
 export { createPinoMixin } from './logs/pino-mixin';
+export { loadNewRelic } from './nr';
 export { FOAM_OTEL_ENDPOINT } from './constants';
 export type { FoamMetrics, Counter, ExpressErrorHandler, ExpressRequestHandler, FastifyPluginAsync, Histogram, InitOptions, NewRelicAgent, ObservableGauge, FoamInstance, SnsMessageAttributeValue, SqsMessage, TraceContext, WinstonFormat, WinstonLogger, WinstonTransport, } from './types';

package/dist/node-cliengo/src/index.js

@@ -12,12 +12,16 @@
  *
  *   The individual function exports exist for tree-shaking and for cases where
  *   a service needs to call e.g. injectJobData() from a file that doesn't have
- *   access to the foam instance.
+ *   access to the foam instance. createFastifyPlugin is NOT exported standalone
+ *   because the raw function takes a tracer argument — use foam.createFastifyPlugin()
+ *   instead.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FOAM_OTEL_ENDPOINT = exports.createPinoMixin = exports.createWinstonFormat = exports.createFastifyPlugin = exports.createExpressErrorHandler = exports.createExpressMiddleware = exports.wrapSqsConsumer = exports.wrapJobConsumer = exports.injectJobData = exports.injectSnsAttributes = exports.getTraceContext = exports.extractParentContext = exports.buildTraceparent = exports.init = void 0;
+exports.FOAM_OTEL_ENDPOINT = exports.loadNewRelic = exports.createPinoMixin = exports.createWinstonFormat = exports.getFastifyRequestTraceContext = exports.createPinoHttpOptions = exports.getRequestTraceContext = exports.createExpressErrorHandler = exports.createExpressMiddleware = exports.wrapSqsConsumer = exports.wrapJobConsumer = exports.injectJobData = exports.injectSnsAttributes = exports.getTraceContext = exports.extractParentContext = exports.buildTraceparent = exports.createFastifyLoggerConfig = exports.getFoam = exports.init = void 0;
 var init_1 = require("./init");
 Object.defineProperty(exports, "init", { enumerable: true, get: function () { return init_1.init; } });
+Object.defineProperty(exports, "getFoam", { enumerable: true, get: function () { return init_1.getFoam; } });
+Object.defineProperty(exports, "createFastifyLoggerConfig", { enumerable: true, get: function () { return init_1.createFastifyLoggerConfig; } });
 var trace_bridge_1 = require("./trace-bridge");
 Object.defineProperty(exports, "buildTraceparent", { enumerable: true, get: function () { return trace_bridge_1.buildTraceparent; } });
 Object.defineProperty(exports, "extractParentContext", { enumerable: true, get: function () { return trace_bridge_1.extractParentContext; } });
@@ -32,11 +36,15 @@ Object.defineProperty(exports, "wrapSqsConsumer", { enumerable: true, get: funct
 var express_1 = require("./http/express");
 Object.defineProperty(exports, "createExpressMiddleware", { enumerable: true, get: function () { return express_1.createExpressMiddleware; } });
 Object.defineProperty(exports, "createExpressErrorHandler", { enumerable: true, get: function () { return express_1.createExpressErrorHandler; } });
+Object.defineProperty(exports, "getRequestTraceContext", { enumerable: true, get: function () { return express_1.getRequestTraceContext; } });
+Object.defineProperty(exports, "createPinoHttpOptions", { enumerable: true, get: function () { return express_1.createPinoHttpOptions; } });
 var fastify_1 = require("./http/fastify");
-Object.defineProperty(exports, "createFastifyPlugin", { enumerable: true, get: function () { return fastify_1.createFastifyPlugin; } });
+Object.defineProperty(exports, "getFastifyRequestTraceContext", { enumerable: true, get: function () { return fastify_1.getRequestTraceContext; } });
 var winston_format_1 = require("./logs/winston-format");
 Object.defineProperty(exports, "createWinstonFormat", { enumerable: true, get: function () { return winston_format_1.createWinstonFormat; } });
 var pino_mixin_1 = require("./logs/pino-mixin");
 Object.defineProperty(exports, "createPinoMixin", { enumerable: true, get: function () { return pino_mixin_1.createPinoMixin; } });
+var nr_1 = require("./nr");
+Object.defineProperty(exports, "loadNewRelic", { enumerable: true, get: function () { return nr_1.loadNewRelic; } });
 var constants_1 = require("./constants");
 Object.defineProperty(exports, "FOAM_OTEL_ENDPOINT", { enumerable: true, get: function () { return constants_1.FOAM_OTEL_ENDPOINT; } });

package/dist/node-cliengo/src/init.d.ts

@@ -24,6 +24,7 @@
  *     features (trace propagation, log enrichment, NR bridging) still work.
  *   - Token undefined + forceExport: throws (fail-fast — you asked to force
  *     export but provided no credentials).
+ *   - Endpoint is always the production Foam endpoint — not configurable.
  *   - Auto-shutdown (SIGTERM/SIGINT): flushes all providers with 5s timeout,
  *     then calls process.exit(0). Without the explicit exit, registering
  *     process.on('SIGTERM') replaces Node's default terminate behavior — services
@@ -48,4 +49,26 @@
  *     global registrations.
  */
 import type { InitOptions, FoamInstance } from './types';
-export declare function init(serviceName: string, token?: string, options?: InitOptions): FoamInstance;
+export declare function init(serviceName: string, options?: InitOptions): FoamInstance;
+/**
+ * Returns the Foam instance for the given service name (or the only instance
+ * if there's just one). Call this from any module after init() has run —
+ * no circular dependency, no holder pattern needed.
+ */
+export declare function getFoam(serviceName?: string): FoamInstance | undefined;
+/**
+ * Standalone Fastify logger config that handles the getFoam() lookup internally.
+ * If Foam is initialized, returns { mixin, stream (multistream with OTLP), ...opts }.
+ * If Foam is not initialized (disabled, not yet called), returns opts as-is —
+ * Fastify gets a plain Pino logger with no OTLP destination.
+ *
+ *   // No getFoam() check or ternary needed:
+ *   Fastify({ logger: createFastifyLoggerConfig({ level: 'info' }) })
+ *
+ *   // Dev with pino-pretty:
+ *   Fastify({ logger: createFastifyLoggerConfig({
+ *     level: 'debug',
+ *     streams: [{ stream: pinoPretty() }],
+ *   })})
+ */
+export declare function createFastifyLoggerConfig(opts?: Record<string, any>): Record<string, any>;