unnbound-logger-sdk 1.0.0

package/dist/utils/trace-context.d.ts

@@ -0,0 +1,10 @@
+declare class TraceContextManager {
+    private static instance;
+    private storage;
+    private constructor();
+    static getInstance(): TraceContextManager;
+    run<T>(traceId: string, callback: () => T): T;
+    getTraceId(): string | undefined;
+}
+export declare const traceContext: TraceContextManager;
+export {};

package/dist/utils/trace-context.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traceContext = void 0;
+const async_hooks_1 = require("async_hooks");
+class TraceContextManager {
+    constructor() {
+        this.storage = new async_hooks_1.AsyncLocalStorage();
+    }
+    static getInstance() {
+        if (!TraceContextManager.instance) {
+            TraceContextManager.instance = new TraceContextManager();
+        }
+        return TraceContextManager.instance;
+    }
+    run(traceId, callback) {
+        return this.storage.run({ traceId }, callback);
+    }
+    getTraceId() {
+        const context = this.storage.getStore();
+        return context?.traceId;
+    }
+}
+exports.traceContext = TraceContextManager.getInstance();

package/dist/utils/with-trace.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Higher-order function that wraps a function with trace context
+ * @param fn - Function to wrap with trace context
+ * @param traceId - Optional trace ID to use (will generate new one if not provided)
+ * @returns Wrapped function that maintains trace context
+ */
+export declare function withTrace<T extends (...args: any[]) => any>(fn: T, traceId?: string): T;

package/dist/utils/with-trace.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTrace = withTrace;
+const uuid_1 = require("uuid");
+const trace_context_1 = require("./trace-context");
+/**
+ * Higher-order function that wraps a function with trace context
+ * @param fn - Function to wrap with trace context
+ * @param traceId - Optional trace ID to use (will generate new one if not provided)
+ * @returns Wrapped function that maintains trace context
+ */
+function withTrace(fn, traceId) {
+    const id = traceId || (0, uuid_1.v4)();
+    return ((...args) => {
+        return trace_context_1.traceContext.run(id, () => fn(...args));
+    });
+}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "unnbound-logger-sdk",
+  "version": "1.0.0",
+  "description": "A structured logging library with TypeScript support using Pino. Provides consistent, well-typed logging across different operational contexts with automatic trace ID propagation.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "test:watch": "jest --watch",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "prepublishOnly": "npm run build && npm test",
+    "check-coverage": "ts-node scripts/check-coverage.ts",
+    "start:example:node-app": "nodemon --watch 'src/**/*.ts' --exec 'ts-node' examples/node-app.ts",
+    "start:example:basic-usage": "nodemon --watch 'src/**/*.ts' --exec 'ts-node' examples/basic-usage.ts"
+  },
+  "keywords": [
+    "logging",
+    "typescript",
+    "structured-logging",
+    "pino",
+    "tracing",
+    "http-logging",
+    "express-middleware",
+    "axios-interceptor",
+    "observability"
+  ],
+  "author": "Unnbound Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unnbound/logger.git"
+  },
+  "homepage": "https://github.com/unnbound/logger#readme",
+  "bugs": {
+    "url": "https://github.com/unnbound/logger/issues"
+  },
+  "dependencies": {
+    "axios": "^1.9.0",
+    "express": "^5.1.0",
+    "pino": "^8.17.2",
+    "uuid": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.24",
+    "@types/uuid": "^9.0.8",
+    "@typescript-eslint/eslint-plugin": "^7.1.0",
+    "@typescript-eslint/parser": "^7.1.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.5.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^10.1.5",
+    "jest": "^29.7.0",
+    "nodemon": "^3.1.10",
+    "prettier": "^3.2.5",
+    "ts-jest": "^29.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "express": "^4.0.0 || ^5.0.0",
+    "axios": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "axios": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist/src/**/*",
+    "dist/index.*",
+    "dist/types.*",
+    "dist/unnbound-logger.*",
+    "dist/utils/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}