unnbound-logger-sdk 3.0.35 → 3.0.37

package/dist/axios.d.ts

@@ -10,8 +10,14 @@ interface HttpClientOptions extends HttpOptions<GetPayload> {
     redact?: RedactOptions | boolean;
 }
 /**
- * Wraps an axios instance to add tracing and span tracking
- * @param axios - The axios instance to wrap
+ * Wraps an axios instance to add tracing and span tracking.
+ *
+ * Idempotent: wrapping an already-wrapped instance returns it unchanged (the second
+ * call's options are ignored). Wrapping mutates the instance in place, so without the
+ * guard each call nests another span layer around the previous wrapper — long-lived
+ * processes that construct clients repeatedly accumulate layers until a single request
+ * overflows the stack (T-3235).
+ * @param client - The axios instance to wrap
  * @param options - Configuration options for HTTP tracing
  * @returns The wrapped axios instance with span tracking
  */

package/dist/axios.js

@@ -37,9 +37,18 @@ const buildOutgoingHttpPayload = (config, res, redact) => ({
 });
 const getNoopPayload = () => ({});
 const onNoopRequest = (config, callback) => callback(config);
+// Global-registry symbol so the guard holds even when several copies of this SDK
+// coexist in one process (e.g. a workflow's own copy plus one nested under another SDK).
+const tracedMarker = Symbol.for('unnbound-logger-sdk.traceAxios.traced');
 /**
- * Wraps an axios instance to add tracing and span tracking
- * @param axios - The axios instance to wrap
+ * Wraps an axios instance to add tracing and span tracking.
+ *
+ * Idempotent: wrapping an already-wrapped instance returns it unchanged (the second
+ * call's options are ignored). Wrapping mutates the instance in place, so without the
+ * guard each call nests another span layer around the previous wrapper — long-lived
+ * processes that construct clients repeatedly accumulate layers until a single request
+ * overflows the stack (T-3235).
+ * @param client - The axios instance to wrap
  * @param options - Configuration options for HTTP tracing
  * @returns The wrapped axios instance with span tracking
  */
@@ -49,6 +58,8 @@ const traceAxios = (client, { ignoreTraceRoutes = types_1.defaultIgnoreTraceRout
     getPayload: getNoopPayload,
     onRequest: onNoopRequest,
 }) => {
+    if (tracedMarker in client)
+        return client;
     const redact = typeof redactOptions === 'boolean' ? { response: redactOptions } : redactOptions;
     const createSpanWrappedRequest = (originalMethod, method) => {
         const { headers: defaultHeaders, ...partialDefaultConfig } = client.defaults;
@@ -91,6 +102,7 @@ const traceAxios = (client, { ignoreTraceRoutes = types_1.defaultIgnoreTraceRout
         const func = createSpanWrappedRequest(request, method);
         client[method] = (url, config) => func({ ...config, method, url });
     });
+    Object.defineProperty(client, tracedMarker, { value: true });
     return client;
 };
 exports.traceAxios = traceAxios;

package/dist/index.d.ts

@@ -4,16 +4,16 @@
  * A structured logging library built on Pino with TypeScript support.
  * Provides consistent, well-typed logging across different operational contexts.
  */
-export type { LogLevel, LogType, HttpMethod, Maybe, EventSource, Log, HttpPayload, SftpPayload, EdiPayload, EdiOperation, EdiFormat, EdiX12Payload, EdiX12Operation, } from './types';
-export { defaultTraceHeaderKey, defaultMessageHeaderKey } from './types';
+export { type OnRequest, traceAxios } from './axios';
+export type { EmitMetricOptions, MetricDefinition, MetricUnit } from './emf';
+export { emitMetric, emitMetrics } from './emf';
+export { decode, encode } from './encode';
 export type { ILogger, UnnboundLogger } from './logger';
 export { logger } from './logger';
-export { encode, decode } from './encode';
-export { withTrace, getTraceId } from './trace';
-export { startSpan } from './span';
-export { traceAxios, type OnRequest } from './axios';
 export { traceMiddleware } from './middleware';
-export { storage, withStorage } from './storage';
+export { startSpan } from './span';
 export type { UnnboundContext } from './storage';
-export type { MetricUnit, MetricDefinition, EmitMetricOptions } from './emf';
-export { emitMetric, emitMetrics } from './emf';
+export { storage, withStorage } from './storage';
+export { getTraceId, withTrace } from './trace';
+export type { EdiFormat, EdiOperation, EdiPayload, EdiX12Operation, EdiX12Payload, EventSource, HttpMethod, HttpPayload, Log, LogLevel, LogType, Maybe, SftpPayload, } from './types';
+export { defaultMessageHeaderKey, defaultTraceHeaderKey } from './types';

package/dist/index.js

@@ -1,26 +1,32 @@
 "use strict";
+/**
+ * unnbound-logger
+ *
+ * A structured logging library built on Pino with TypeScript support.
+ * Provides consistent, well-typed logging across different operational contexts.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.emitMetrics = exports.emitMetric = exports.withStorage = exports.storage = exports.traceMiddleware = exports.traceAxios = exports.startSpan = exports.getTraceId = exports.withTrace = exports.decode = exports.encode = exports.logger = exports.defaultMessageHeaderKey = exports.defaultTraceHeaderKey = void 0;
-var types_1 = require("./types");
-Object.defineProperty(exports, "defaultTraceHeaderKey", { enumerable: true, get: function () { return types_1.defaultTraceHeaderKey; } });
-Object.defineProperty(exports, "defaultMessageHeaderKey", { enumerable: true, get: function () { return types_1.defaultMessageHeaderKey; } });
-var logger_1 = require("./logger");
-Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
-var encode_1 = require("./encode");
-Object.defineProperty(exports, "encode", { enumerable: true, get: function () { return encode_1.encode; } });
-Object.defineProperty(exports, "decode", { enumerable: true, get: function () { return encode_1.decode; } });
-var trace_1 = require("./trace");
-Object.defineProperty(exports, "withTrace", { enumerable: true, get: function () { return trace_1.withTrace; } });
-Object.defineProperty(exports, "getTraceId", { enumerable: true, get: function () { return trace_1.getTraceId; } });
-var span_1 = require("./span");
-Object.defineProperty(exports, "startSpan", { enumerable: true, get: function () { return span_1.startSpan; } });
+exports.defaultTraceHeaderKey = exports.defaultMessageHeaderKey = exports.withTrace = exports.getTraceId = exports.withStorage = exports.storage = exports.startSpan = exports.traceMiddleware = exports.logger = exports.encode = exports.decode = exports.emitMetrics = exports.emitMetric = exports.traceAxios = void 0;
 var axios_1 = require("./axios");
 Object.defineProperty(exports, "traceAxios", { enumerable: true, get: function () { return axios_1.traceAxios; } });
+var emf_1 = require("./emf");
+Object.defineProperty(exports, "emitMetric", { enumerable: true, get: function () { return emf_1.emitMetric; } });
+Object.defineProperty(exports, "emitMetrics", { enumerable: true, get: function () { return emf_1.emitMetrics; } });
+var encode_1 = require("./encode");
+Object.defineProperty(exports, "decode", { enumerable: true, get: function () { return encode_1.decode; } });
+Object.defineProperty(exports, "encode", { enumerable: true, get: function () { return encode_1.encode; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
 var middleware_1 = require("./middleware");
 Object.defineProperty(exports, "traceMiddleware", { enumerable: true, get: function () { return middleware_1.traceMiddleware; } });
+var span_1 = require("./span");
+Object.defineProperty(exports, "startSpan", { enumerable: true, get: function () { return span_1.startSpan; } });
 var storage_1 = require("./storage");
 Object.defineProperty(exports, "storage", { enumerable: true, get: function () { return storage_1.storage; } });
 Object.defineProperty(exports, "withStorage", { enumerable: true, get: function () { return storage_1.withStorage; } });
-var emf_1 = require("./emf");
-Object.defineProperty(exports, "emitMetric", { enumerable: true, get: function () { return emf_1.emitMetric; } });
-Object.defineProperty(exports, "emitMetrics", { enumerable: true, get: function () { return emf_1.emitMetrics; } });
+var trace_1 = require("./trace");
+Object.defineProperty(exports, "getTraceId", { enumerable: true, get: function () { return trace_1.getTraceId; } });
+Object.defineProperty(exports, "withTrace", { enumerable: true, get: function () { return trace_1.withTrace; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "defaultMessageHeaderKey", { enumerable: true, get: function () { return types_1.defaultMessageHeaderKey; } });
+Object.defineProperty(exports, "defaultTraceHeaderKey", { enumerable: true, get: function () { return types_1.defaultTraceHeaderKey; } });

package/dist/internal.js

@@ -2,8 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.internal = exports.hidden = void 0;
 const o = { _internal: true };
-// Internal logs should be hidden in sandbox
-// TODO: Find a better way to detect sandbox
+// Sandbox-internal logs are hidden from customer-visible streams.
 if (process.env.UNNBOUND_IDLE_TIMEOUT)
     o._hide = true;
 const hidden = (data) => '_hide' in data && data._hide;

package/dist/logger.d.ts

@@ -1,12 +1,13 @@
 import pino from 'pino';
+import type { DestinationStream } from 'pino';
 export interface ILogger {
-    trace(object: {}, message: string): void;
+    trace(object: object, message: string): void;
     trace(message: string): void;
-    debug(object: {}, message: string): void;
+    debug(object: object, message: string): void;
     debug(message: string): void;
-    info(object: {}, message: string): void;
+    info(object: object, message: string): void;
     info(message: string): void;
-    warn(object: {}, message: string): void;
+    warn(object: object, message: string): void;
     warn(message: string): void;
     error<O extends {
         err: unknown;
@@ -14,4 +15,5 @@ export interface ILogger {
 }
 export interface UnnboundLogger extends ILogger, Omit<pino.Logger, keyof ILogger> {
 }
+export declare const createLogger: (destination?: DestinationStream) => UnnboundLogger;
 export declare const logger: UnnboundLogger;

package/dist/logger.js

@@ -3,15 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.logger = void 0;
+exports.logger = exports.createLogger = void 0;
 const pino_1 = __importDefault(require("pino"));
 const uuid_1 = require("uuid");
 const encode_1 = require("./encode");
 const internal_1 = require("./internal");
 const storage_1 = require("./storage");
 const levels = new Set(['debug', 'info', 'warn', 'error']);
+const workflowEnvironment = process.env.WORKFLOW_ENV ?? process.env.UNNBOUND_ENVIRONMENT ?? process.env.ENVIRONMENT;
 const formatLevel = (level) => ({ level });
-// TODO: Check if there is a better way to encode the log object.
 const formatLog = (log, visited = new WeakSet()) => {
     // Prevent infinite loops from circular references
     if (visited.has(log))
@@ -22,6 +22,12 @@ const formatLog = (log, visited = new WeakSet()) => {
         return log;
     // We don't use Object.entries() for performance reasons
     for (const key in log) {
+        if (!Object.hasOwn(log, key))
+            continue;
+        // JSON.parse produces own '__proto__'/'constructor' keys; assigning to them
+        // routes through Object.prototype setters and pollutes the prototype chain.
+        if (key === '__proto__' || key === 'constructor' || key === 'prototype')
+            continue;
         const value = log[key];
         // We don't want to encode undefined values.
         if (value === undefined)
@@ -39,16 +45,19 @@ const formatLog = (log, visited = new WeakSet()) => {
                     ? formatLog(item, visited)
                     : item);
         }
-        else if (typeof value === 'object') {
+        else if (value !== null && typeof value === 'object') {
             log[key] = formatLog(value, visited);
         }
     }
     return log;
 };
-exports.logger = (0, pino_1.default)({
+const loggerOptions = {
     level: process.env.LOG_LEVEL ?? 'debug',
     base: {
-        environment: process.env.ENVIRONMENT,
+        // The Pulumi stack name is internal platform vocabulary — never stamp it into
+        // the customer-visible envelope (T-3235). Platform stack attribution flows via
+        // OTel resource attributes into the ClickHouse `stack` column instead (T-2236).
+        environment: workflowEnvironment,
         workflowId: process.env.UNNBOUND_WORKFLOW_ID,
         serviceId: process.env.UNNBOUND_SERVICE_ID,
         deploymentId: process.env.UNNBOUND_DEPLOYMENT_ID,
@@ -69,17 +78,18 @@ exports.logger = (0, pino_1.default)({
     hooks: {
         logMethod(args, method) {
             const firstArg = args[0];
+            let activeMethod = method;
             if (!!firstArg && typeof firstArg === 'object') {
                 // If the log entry is considered hidden, don't log it
                 if ((0, internal_1.hidden)(firstArg))
                     return;
                 // Dynamic log level by allowing overwriting the log level
                 if ('level' in firstArg && typeof firstArg.level === 'string' && levels.has(firstArg.level)) {
-                    method = this[firstArg.level];
+                    activeMethod = this[firstArg.level];
                     firstArg.level = undefined;
                 }
             }
-            method.apply(this, args);
+            activeMethod.apply(this, args);
         },
     },
     redact: {
@@ -92,7 +102,10 @@ exports.logger = (0, pino_1.default)({
         ],
         remove: true,
     },
-});
+};
+const createLogger = (destination) => destination ? (0, pino_1.default)(loggerOptions, destination) : (0, pino_1.default)(loggerOptions);
+exports.createLogger = createLogger;
+exports.logger = (0, exports.createLogger)();
 process.on('uncaughtException', (err, origin) => {
     try {
         exports.logger.error({ err, origin }, 'Uncaught exception.');

package/dist/middleware.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.traceMiddleware = void 0;
 const span_1 = require("./span");
-const types_1 = require("./types");
 const trace_1 = require("./trace");
+const types_1 = require("./types");
 const utils_1 = require("./utils");
 const extractQueryParams = (url) => {
     const object = new URL(url);

package/package.json

@@ -1,24 +1,11 @@
 {
   "name": "unnbound-logger-sdk",
   "description": "A structured logging library with TypeScript support using Pino. Provides consistent, well-typed logging with automatic logId, workflowId, traceId, and deploymentId tracking across operational contexts.",
-  "version": "3.0.35",
+  "version": "3.0.37",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "bun x tsc",
-    "test": "echo 'No tests'",
-    "typecheck": "tsc -noEmit",
-    "lint": "eslint --cache --cache-location ./node_modules/.cache/eslint .",
-    "lint:fix": "bun run lint --fix",
-    "format": "biome format --write .",
-    "format:check": "biome format .",
-    "prepublishOnly": "bun run build",
-    "start:example": "bun --watch examples/node-express.ts",
-    "version:bump": "npm version patch"
-  },
   "keywords": [
     "logging",
-    "typescript",
     "structured-logging",
     "pino",
     "tracing",
@@ -38,19 +25,19 @@
     "url": "https://github.com/unnbounddev/unnbound-sdks/issues"
   },
   "dependencies": {
-    "axios": "^1.12.2",
+    "axios": "1.16.0",
     "express": "^4.0.0 || ^5.0.0",
-    "pino": "^8.17.2",
-    "uuid": "^11.1.0"
+    "pino": "^10.3.1",
+    "uuid": "^11.1.1"
   },
   "devDependencies": {
     "@types/express": "^4.17.21",
-    "@types/node": "^22",
+    "@types/node": "^24.12.2",
     "@types/uuid": "^9.0.8",
-    "typescript": "^5.9.3"
+    "vitest": "^4.0.15"
   },
   "peerDependencies": {
-    "axios": "^1.12.2",
+    "axios": "^1.15.1",
     "express": "^4.0.0 || ^5.0.0"
   },
   "peerDependenciesMeta": {
@@ -69,5 +56,14 @@
   "engines": {
     "node": ">=22"
   },
-  "sideEffects": false
-}
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run src",
+    "typecheck": "tsc --noEmit",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "start:example": "tsx watch examples/node-express.ts",
+    "version:bump": "npm version patch"
+  }
+}