unnbound-logger-sdk 3.0.19 → 3.0.20

package/README.md

@@ -395,6 +395,7 @@ app.use(traceMiddleware(options?: HttpOptions));
 **HttpOptions:**
 
 - `traceHeaderKey?: string` - Custom trace header name (default: 'x-unnbound-trace-id')
+- `messageHeaderKey?: string` - Custom message header name (default: 'x-message-id')
 - `ignoreTraceRoutes?: string[]` - Routes to ignore in middleware (default: ['/health', '/healthcheck'])
 
 ### traceAxios

package/dist/middleware.d.ts

@@ -6,5 +6,5 @@ interface Response {
     body?: unknown;
 }
 type GetPayload = (config: Request, res?: Response) => object;
-export declare const traceMiddleware: ({ ignoreTraceRoutes, traceHeaderKey, getPayload, }?: HttpOptions<GetPayload>) => RequestHandler;
+export declare const traceMiddleware: ({ ignoreTraceRoutes, traceHeaderKey, messageHeaderKey, getPayload, }?: HttpOptions<GetPayload>) => RequestHandler;
 export {};

package/dist/middleware.js

@@ -47,14 +47,16 @@ const buildIncomingHttpPayload = (req, res) => ({
     },
 });
 const getNoopPayload = () => ({});
-const traceMiddleware = ({ ignoreTraceRoutes = types_1.defaultIgnoreTraceRoutes, traceHeaderKey = types_1.defaultTraceHeaderKey, getPayload = getNoopPayload, } = {
+const traceMiddleware = ({ ignoreTraceRoutes = types_1.defaultIgnoreTraceRoutes, traceHeaderKey = types_1.defaultTraceHeaderKey, messageHeaderKey = types_1.defaultMessageHeaderKey, getPayload = getNoopPayload, } = {
     ignoreTraceRoutes: types_1.defaultIgnoreTraceRoutes,
     traceHeaderKey: types_1.defaultTraceHeaderKey,
+    messageHeaderKey: types_1.defaultMessageHeaderKey,
     getPayload: getNoopPayload,
 }) => async (req, res, next) => {
     if ((0, utils_1.shouldIgnorePath)(req.path, ignoreTraceRoutes))
         return next();
     const traceId = req.header(traceHeaderKey) || (0, trace_1.getTraceId)();
+    const messageId = req.header(messageHeaderKey) || undefined;
     res.setHeader(traceHeaderKey, traceId);
     return await (0, trace_1.withTrace)(async () => {
         return await (0, span_1.startSpan)('Incoming HTTP request', async () => {
@@ -78,6 +80,6 @@ const traceMiddleware = ({ ignoreTraceRoutes = types_1.defaultIgnoreTraceRoutes,
                 : undefined;
             return { ...buildIncomingHttpPayload(req, response), ...getPayload(req, response) };
         });
-    }, { traceId });
+    }, messageId ? { traceId, messageId } : { traceId });
 };
 exports.traceMiddleware = traceMiddleware;

package/dist/trace.d.ts

@@ -3,6 +3,11 @@
  * @returns A trace ID
  */
 export declare const getTraceId: () => string;
+/**
+ * Generates a message ID
+ * @returns A message ID
+ */
+export declare const getMessageId: () => string;
 /**
  * Runs a callback with a trace ID
  * @param callback - The callback to run

package/dist/trace.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withTrace = exports.getTraceId = void 0;
+exports.withTrace = exports.getMessageId = exports.getTraceId = void 0;
 const uuid_1 = require("uuid");
 const storage_1 = require("./storage");
 /**
@@ -9,6 +9,12 @@ const storage_1 = require("./storage");
  */
 const getTraceId = () => (0, uuid_1.v4)();
 exports.getTraceId = getTraceId;
+/**
+ * Generates a message ID
+ * @returns A message ID
+ */
+const getMessageId = () => (0, uuid_1.v4)();
+exports.getMessageId = getMessageId;
 /**
  * Runs a callback with a trace ID
  * @param callback - The callback to run
@@ -18,6 +24,7 @@ exports.getTraceId = getTraceId;
 const withTrace = (callback, extra) => {
     const previous = storage_1.storage.getStore();
     const traceId = extra?.traceId ?? previous?.traceId ?? (0, exports.getTraceId)();
-    return storage_1.storage.run({ ...previous, ...extra, traceId }, callback);
+    const messageId = extra?.messageId ?? previous?.messageId ?? (0, exports.getMessageId)();
+    return storage_1.storage.run({ ...previous, ...extra, traceId, messageId }, callback);
 };
 exports.withTrace = withTrace;

package/dist/types.d.ts

@@ -69,7 +69,9 @@ export interface EdiPayload {
 export interface HttpOptions<G extends Function> {
     ignoreTraceRoutes?: string[];
     traceHeaderKey?: string;
+    messageHeaderKey?: string;
     getPayload?: G;
 }
 export declare const defaultIgnoreTraceRoutes: string[];
 export declare const defaultTraceHeaderKey = "x-unnbound-trace-id";
+export declare const defaultMessageHeaderKey = "x-message-id";

package/dist/types.js

@@ -3,6 +3,7 @@
  * Type definitions for structured logging library
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultTraceHeaderKey = exports.defaultIgnoreTraceRoutes = void 0;
+exports.defaultMessageHeaderKey = exports.defaultTraceHeaderKey = exports.defaultIgnoreTraceRoutes = void 0;
 exports.defaultIgnoreTraceRoutes = ['/health', '/healthcheck'];
 exports.defaultTraceHeaderKey = 'x-unnbound-trace-id';
+exports.defaultMessageHeaderKey = 'x-message-id';

package/package.json

@@ -1,9 +1,23 @@
 {
   "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.19",
+  "version": "3.0.20",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "test:watch": "jest --watch",
+    "typecheck": "tsc -noEmit",
+    "lint": "eslint --cache --cache-location ./node_modules/.cache/eslint .",
+    "lint:fix": "pnpm lint --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepublishOnly": "pnpm build",
+    "start:example": "npx --yes tsx --watch examples/node-express.ts",
+    "version:bump": "npm version patch"
+  },
   "keywords": [
     "logging",
     "typescript",
@@ -57,18 +71,5 @@
   "engines": {
     "node": ">=22"
   },
-  "sideEffects": false,
-  "scripts": {
-    "build": "tsc",
-    "test": "jest",
-    "test:coverage": "jest --coverage",
-    "test:watch": "jest --watch",
-    "typecheck": "tsc -noEmit",
-    "lint": "eslint --cache --cache-location ./node_modules/.cache/eslint .",
-    "lint:fix": "pnpm lint --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "start:example": "npx --yes tsx --watch examples/node-express.ts",
-    "version:bump": "npm version patch"
-  }
-}
+  "sideEffects": false
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Unnbound Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.