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

package/dist/axios.d.ts

@@ -8,18 +8,19 @@ 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.
- *
- * 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
+ * Wraps an axios instance to add tracing and span tracking
+ * @param axios - The axios instance to wrap
  * @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

@@ -37,29 +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.
- *
- * 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
+ * Wraps an axios instance to add tracing and span tracking
+ * @param axios - The axios instance to wrap
  * @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,
     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;
@@ -73,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) => {
@@ -102,7 +93,6 @@ 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

@@ -15,5 +15,5 @@ export { startSpan } from './span';
 export type { UnnboundContext } from './storage';
 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 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/logger.js

@@ -11,6 +11,7 @@ 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 });
 const formatLog = (log, visited = new WeakSet()) => {
     // Prevent infinite loops from circular references
@@ -54,10 +55,8 @@ const formatLog = (log, visited = new WeakSet()) => {
 const loggerOptions = {
     level: process.env.LOG_LEVEL ?? 'debug',
     base: {
-        // 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,
+        stack: stackEnvironment,
         workflowId: process.env.UNNBOUND_WORKFLOW_ID,
         serviceId: process.env.UNNBOUND_SERVICE_ID,
         deploymentId: process.env.UNNBOUND_DEPLOYMENT_ID,

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,7 +1,7 @@
 {
   "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.37",
+  "version": "3.1.0-beta.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "keywords": [