unnbound-logger-sdk 3.0.36 → 3.1.0-beta.0

package/dist/axios.d.ts

@@ -8,6 +8,13 @@ export type OnRequest = (config: AxiosRequestConfig, callback: (config: AxiosReq
 interface HttpClientOptions extends HttpOptions<GetPayload> {
     onRequest?: OnRequest;
     redact?: RedactOptions | boolean;
+    /**
+     * Propagate correlation headers but emit no request/response logs, in every
+     * environment. For internal platform transports whose payloads must never become
+     * customer-visible (e.g. AS2 envelopes and MDNs) — unlike the `internal()` payload
+     * marker, suppression does not depend on runtime env vars.
+     */
+    silent?: boolean;
 }
 /**
  * Wraps an axios instance to add tracing and span tracking
@@ -15,5 +22,5 @@ interface HttpClientOptions extends HttpOptions<GetPayload> {
  * @param options - Configuration options for HTTP tracing
  * @returns The wrapped axios instance with span tracking
  */
-export declare const traceAxios: (client: AxiosInstance, { ignoreTraceRoutes, traceHeaderKey, getPayload, onRequest, redact: redactOptions, }?: HttpClientOptions) => AxiosInstance;
+export declare const traceAxios: (client: AxiosInstance, { ignoreTraceRoutes, traceHeaderKey, getPayload, onRequest, redact: redactOptions, silent, }?: HttpClientOptions) => AxiosInstance;
 export {};

package/dist/axios.js

@@ -43,7 +43,7 @@ const onNoopRequest = (config, callback) => callback(config);
  * @param options - Configuration options for HTTP tracing
  * @returns The wrapped axios instance with span tracking
  */
-const traceAxios = (client, { ignoreTraceRoutes = types_1.defaultIgnoreTraceRoutes, traceHeaderKey = types_1.defaultTraceHeaderKey, getPayload = getNoopPayload, onRequest = onNoopRequest, redact: redactOptions, } = {
+const traceAxios = (client, { ignoreTraceRoutes = types_1.defaultIgnoreTraceRoutes, traceHeaderKey = types_1.defaultTraceHeaderKey, getPayload = getNoopPayload, onRequest = onNoopRequest, redact: redactOptions, silent = false, } = {
     ignoreTraceRoutes: types_1.defaultIgnoreTraceRoutes,
     traceHeaderKey: types_1.defaultTraceHeaderKey,
     getPayload: getNoopPayload,
@@ -62,6 +62,8 @@ const traceAxios = (client, { ignoreTraceRoutes = types_1.defaultIgnoreTraceRout
                 return originalMethod(config);
             const traceId = storage_1.storage.getStore()?.traceId;
             config = { ...config, headers: { ...config.headers, [traceHeaderKey]: traceId } };
+            if (silent)
+                return onRequest(config, (config) => originalMethod(config));
             return onRequest(config, (config) => {
                 // Execute the request within a span
                 return (0, span_1.startSpan)('Outgoing HTTP request', () => originalMethod(config), (options) => {

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 { As2Operation, As2Outcome, As2Payload, 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,18 +3,17 @@ 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 stackEnvironment = process.env.ENVIRONMENT ?? process.env.APP_ENV;
 const formatLevel = (level) => ({ level });
-// TODO: Check if there is a better way to encode the log object.
 const formatLog = (log, visited = new WeakSet()) => {
-    if (!log || typeof log !== 'object')
-        return log;
     // Prevent infinite loops from circular references
     if (visited.has(log))
         return log;
@@ -24,6 +23,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)
@@ -47,10 +52,11 @@ const formatLog = (log, visited = new WeakSet()) => {
     }
     return log;
 };
-exports.logger = (0, pino_1.default)({
+const loggerOptions = {
     level: process.env.LOG_LEVEL ?? 'debug',
     base: {
-        environment: process.env.ENVIRONMENT,
+        environment: workflowEnvironment,
+        stack: stackEnvironment,
         workflowId: process.env.UNNBOUND_WORKFLOW_ID,
         serviceId: process.env.UNNBOUND_SERVICE_ID,
         deploymentId: process.env.UNNBOUND_DEPLOYMENT_ID,
@@ -71,17 +77,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: {
@@ -94,7 +101,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/dist/types.d.ts

@@ -1,5 +1,5 @@
 export type LogLevel = 'info' | 'debug' | 'error' | 'warn';
-export type LogType = 'general' | 'http' | 'sftp' | 'edi';
+export type LogType = 'general' | 'http' | 'sftp' | 'edi' | 'as2';
 export type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
 export type EventSource = 'http' | 'queue';
 export type Maybe<T> = {
@@ -22,6 +22,7 @@ export interface Log<T extends LogType = 'general'> {
     http: T extends 'http' ? HttpPayload : never;
     sftp: T extends 'sftp' ? SftpPayload : never;
     edi: T extends 'edi' ? EdiPayload : never;
+    as2: T extends 'as2' ? As2Payload : never;
     duration?: number;
     err?: unknown;
 }
@@ -63,6 +64,39 @@ export interface EdiPayload {
     type: EdiFormat;
     x12?: EdiX12Payload;
 }
+export type As2Operation = 'send' | 'deliver' | 'receive' | 'acknowledge' | 'mdn-generate' | 'mdn-deliver' | 'mdn-verify';
+export type As2Outcome = 'confirmed' | 'failed' | 'pending' | 'received' | 'duplicate' | 'inFlight' | 'parked' | 'delivered' | 'generated' | 'verified';
+/**
+ * Customer-visible AS2 protocol milestone. Metadata only, by contract: AS2 transport
+ * bodies are plaintext business documents, sealed envelopes, and signed MDNs, so this
+ * payload must never carry bodies, full URLs, tokens, or certificate material.
+ */
+export interface As2Payload {
+    operation: As2Operation;
+    /** AS2 protocol Message-ID. The log root's messageId stays the Temper event identifier. */
+    messageId?: string;
+    /** Original-Message-ID of the message an MDN settles. */
+    originalMessageId?: string;
+    /** Customer trace that originated the transaction, linked from async callback traces. */
+    originatingTraceId?: string;
+    /** Partner config reference (a variable name), never a URL or certificate. */
+    partner?: string;
+    /** Destination host only — never full URLs or query strings. */
+    host?: string;
+    byteLength?: number;
+    contentType?: string;
+    mdnMode?: 'sync' | 'async';
+    replayed?: boolean;
+    attempt?: number;
+    /** HTTP status of a delivery POST. */
+    status?: number;
+    outcome?: As2Outcome;
+    /** Normalized MDN disposition, e.g. "automatic-action/MDN-sent-automatically; processed". */
+    disposition?: string;
+    micMatched?: boolean;
+    /** Normalized safe error code (As2SdkError.code), never a stack trace. */
+    errorCode?: string;
+}
 export interface HttpOptions<G extends Function> {
     ignoreTraceRoutes?: string[];
     traceHeaderKey?: string;

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.36",
+  "version": "3.1.0-beta.0",
   "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"
+  }
+}