observability-kit 0.1.1

package/dist/nest/interceptors/request.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.interceptor.js","sourceRoot":"","sources":["../../../src/nest/interceptors/request.interceptor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAOwB;AACxB,+BAAkC;AAClC,6CAAyC;AAEzC,8EAAuE;AAKvE,4CAAoD;AAG7C,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IACV,UAAU,CAAS;IACnB,oBAAoB,CAAU;IAE/C,YAGE,OAAkC;QAElC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,mBAAmB,IAAI,cAAc,CAAC;QACjE,IAAI,CAAC,oBAAoB,GAAG,OAAO,EAAE,oBAAoB,IAAI,KAAK,CAAC;IACrE,CAAC;IAED,SAAS,CACP,gBAAkC,EAClC,IAAiB;QAEjB,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAU,CAAC;QAChD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,GAAG,GAAG,gBAAgB,CAAC,YAAY,EAAE,CAAC,UAAU,EAAW,CAAC;QAClE,MAAM,GAAG,GAAG,gBAAgB,CAAC,YAAY,EAAE,CAAC,WAAW,EAAY,CAAC;QAEpE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,SAAS,GACb,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YACvD,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,IAAA,wBAAU,GAAE,CAAC;QAEnB,MAAM,OAAO,GAAmB;YAC9B,SAAS;YACT,QAAQ,EAAE,GAAG,CAAC,IAAI;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC;QAEF,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,iBAAU,CAAC,CAAC,UAAU,EAAE,EAAE;YACnC,IAAA,mCAAc,EAAC,OAAO,EAAE,GAAG,EAAE;gBAC3B,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,SAAS,CAAC,GAAY,EAAE,IAAY;QAC1C,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACzC,CAAC;CACF,CAAA;AAnDY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,mBAAU,GAAE;IAMR,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,eAAM,EAAC,gCAAoB,CAAC,CAAA;;GANpB,gBAAgB,CAmD5B"}

package/dist/nest/module/trace-logger.module.d.ts

@@ -0,0 +1,8 @@
+import { DynamicModule } from '@nestjs/common';
+import type { TraceLoggerModuleOptions } from '../../types/options.js';
+import { TRACE_LOGGER_OPTIONS } from '../tokens.js';
+export { TRACE_LOGGER_OPTIONS };
+export declare class TraceLoggerModule {
+    static forRoot(options: TraceLoggerModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=trace-logger.module.d.ts.map

package/dist/nest/module/trace-logger.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-logger.module.d.ts","sourceRoot":"","sources":["../../../src/nest/module/trace-logger.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAI/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC,qBAEa,iBAAiB;IAC5B,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,wBAAwB,GAAG,aAAa;CAejE"}

package/dist/nest/module/trace-logger.module.js

@@ -0,0 +1,38 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var TraceLoggerModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceLoggerModule = exports.TRACE_LOGGER_OPTIONS = void 0;
+const common_1 = require("@nestjs/common");
+const structured_logger_js_1 = require("../../core/logger/structured-logger.js");
+const nest_adapter_js_1 = require("../adapters/nest.adapter.js");
+const request_interceptor_js_1 = require("../interceptors/request.interceptor.js");
+const tokens_js_1 = require("../tokens.js");
+Object.defineProperty(exports, "TRACE_LOGGER_OPTIONS", { enumerable: true, get: function () { return tokens_js_1.TRACE_LOGGER_OPTIONS; } });
+let TraceLoggerModule = TraceLoggerModule_1 = class TraceLoggerModule {
+    static forRoot(options) {
+        structured_logger_js_1.logger.setAdapter(new nest_adapter_js_1.NestLogAdapter());
+        return {
+            module: TraceLoggerModule_1,
+            providers: [
+                {
+                    provide: tokens_js_1.TRACE_LOGGER_OPTIONS,
+                    useValue: options,
+                },
+                request_interceptor_js_1.TraceInterceptor,
+            ],
+            exports: [tokens_js_1.TRACE_LOGGER_OPTIONS, request_interceptor_js_1.TraceInterceptor],
+        };
+    }
+};
+exports.TraceLoggerModule = TraceLoggerModule;
+exports.TraceLoggerModule = TraceLoggerModule = TraceLoggerModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], TraceLoggerModule);
+//# sourceMappingURL=trace-logger.module.js.map

package/dist/nest/module/trace-logger.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-logger.module.js","sourceRoot":"","sources":["../../../src/nest/module/trace-logger.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA+D;AAC/D,iFAAgE;AAChE,iEAA6D;AAC7D,mFAA0E;AAE1E,4CAAoD;AAE3C,qGAFA,gCAAoB,OAEA;AAItB,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAC5B,MAAM,CAAC,OAAO,CAAC,OAAiC;QAC9C,6BAAM,CAAC,UAAU,CAAC,IAAI,gCAAc,EAAE,CAAC,CAAC;QAExC,OAAO;YACL,MAAM,EAAE,mBAAiB;YACzB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,gCAAoB;oBAC7B,QAAQ,EAAE,OAAO;iBAClB;gBACD,yCAAgB;aACjB;YACD,OAAO,EAAE,CAAC,gCAAoB,EAAE,yCAAgB,CAAC;SAClD,CAAC;IACJ,CAAC;CACF,CAAA;AAhBY,8CAAiB;4BAAjB,iBAAiB;IAF7B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,iBAAiB,CAgB7B"}

package/dist/nest/tokens.d.ts

@@ -0,0 +1,2 @@
+export declare const TRACE_LOGGER_OPTIONS: unique symbol;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/nest/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/nest/tokens.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAiC,CAAC"}

package/dist/nest/tokens.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRACE_LOGGER_OPTIONS = void 0;
+exports.TRACE_LOGGER_OPTIONS = Symbol('TRACE_LOGGER_OPTIONS');
+//# sourceMappingURL=tokens.js.map

package/dist/nest/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/nest/tokens.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/nestjs.d.ts

@@ -0,0 +1,8 @@
+export * from './index.js';
+export { TraceLoggerModule, TRACE_LOGGER_OPTIONS } from './nest/module/trace-logger.module.js';
+export { TraceInterceptor } from './nest/interceptors/request.interceptor.js';
+export { RequestLog } from './nest/decorators/request-log.decorator.js';
+export { ServiceLog } from './nest/decorators/service-log.decorator.js';
+export { StepLog } from './nest/decorators/step-log.decorator.js';
+export { NestLogAdapter } from './nest/adapters/nest.adapter.js';
+//# sourceMappingURL=nestjs.d.ts.map

package/dist/nestjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs.d.ts","sourceRoot":"","sources":["../src/nestjs.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,4CAA4C,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,4CAA4C,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/nestjs.js

@@ -0,0 +1,32 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NestLogAdapter = exports.StepLog = exports.ServiceLog = exports.RequestLog = exports.TraceInterceptor = exports.TRACE_LOGGER_OPTIONS = exports.TraceLoggerModule = void 0;
+__exportStar(require("./index.js"), exports);
+var trace_logger_module_js_1 = require("./nest/module/trace-logger.module.js");
+Object.defineProperty(exports, "TraceLoggerModule", { enumerable: true, get: function () { return trace_logger_module_js_1.TraceLoggerModule; } });
+Object.defineProperty(exports, "TRACE_LOGGER_OPTIONS", { enumerable: true, get: function () { return trace_logger_module_js_1.TRACE_LOGGER_OPTIONS; } });
+var request_interceptor_js_1 = require("./nest/interceptors/request.interceptor.js");
+Object.defineProperty(exports, "TraceInterceptor", { enumerable: true, get: function () { return request_interceptor_js_1.TraceInterceptor; } });
+var request_log_decorator_js_1 = require("./nest/decorators/request-log.decorator.js");
+Object.defineProperty(exports, "RequestLog", { enumerable: true, get: function () { return request_log_decorator_js_1.RequestLog; } });
+var service_log_decorator_js_1 = require("./nest/decorators/service-log.decorator.js");
+Object.defineProperty(exports, "ServiceLog", { enumerable: true, get: function () { return service_log_decorator_js_1.ServiceLog; } });
+var step_log_decorator_js_1 = require("./nest/decorators/step-log.decorator.js");
+Object.defineProperty(exports, "StepLog", { enumerable: true, get: function () { return step_log_decorator_js_1.StepLog; } });
+var nest_adapter_js_1 = require("./nest/adapters/nest.adapter.js");
+Object.defineProperty(exports, "NestLogAdapter", { enumerable: true, get: function () { return nest_adapter_js_1.NestLogAdapter; } });
+//# sourceMappingURL=nestjs.js.map

package/dist/nestjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs.js","sourceRoot":"","sources":["../src/nestjs.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAE3B,+EAA+F;AAAtF,2HAAA,iBAAiB,OAAA;AAAE,8HAAA,oBAAoB,OAAA;AAChD,qFAA8E;AAArE,0HAAA,gBAAgB,OAAA;AACzB,uFAAwE;AAA/D,sHAAA,UAAU,OAAA;AACnB,uFAAwE;AAA/D,sHAAA,UAAU,OAAA;AACnB,iFAAkE;AAAzD,gHAAA,OAAO,OAAA;AAChB,mEAAiE;AAAxD,iHAAA,cAAc,OAAA"}

package/dist/types/options.d.ts

@@ -0,0 +1,39 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface RequestContext {
+    requestId: string;
+    endpoint?: string;
+    method?: string;
+    service?: string;
+}
+export interface StartContextOptions {
+    requestId?: string;
+    endpoint?: string;
+    method?: string;
+    service?: string;
+}
+export interface DefaultLevels {
+    requestStart?: LogLevel;
+    requestEnd?: LogLevel;
+    requestError?: LogLevel;
+    serviceEnter?: LogLevel;
+    step?: LogLevel;
+}
+export interface TraceLoggerModuleOptions {
+    serviceName: string;
+    requestIdHeaderName?: string;
+    enableResponseHeader?: boolean;
+    defaultLevels?: DefaultLevels;
+}
+export interface RequestLogOptions {
+    payloadBuilder?: (...args: unknown[]) => Record<string, unknown> | undefined;
+}
+export interface ServiceLogOptions {
+    payloadBuilder?: (...args: unknown[]) => Record<string, unknown> | undefined;
+    level?: LogLevel;
+    logExit?: boolean;
+}
+export interface StepLogOptions {
+    payloadBuilder?: (...args: unknown[]) => Record<string, unknown> | undefined;
+    level?: LogLevel;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/types/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC9E;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7E,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7E,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB"}

package/dist/types/options.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=options.js.map

package/dist/types/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,123 @@
+{
+  "name": "observability-kit",
+  "version": "0.1.1",
+  "description": "Reusable structured logging and request-tracing library for NestJS and plain Node.js",
+  "author": "",
+  "private": false,
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./nestjs": {
+      "types": "./dist/nestjs.d.ts",
+      "default": "./dist/nestjs.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Kaitach/observability-kit"
+  },
+  "homepage": "https://github.com/Kaitach/observability-kit#readme",
+  "bugs": {
+    "url": "https://github.com/Kaitach/observability-kit/issues"
+  },
+  "keywords": [
+    "nestjs",
+    "logging",
+    "tracing",
+    "request-id",
+    "observability",
+    "async-local-storage",
+    "structured-logging"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:nest": "nest build",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
+    "test:e2e": "jest --config ./test/jest-e2e.json"
+  },
+  "dependencies": {
+    "pino": "^10.3.1"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/core": ">=10.0.0",
+    "reflect-metadata": ">=0.1.12",
+    "rxjs": ">=7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/core": {
+      "optional": true
+    },
+    "reflect-metadata": {
+      "optional": true
+    },
+    "rxjs": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/platform-express": "^11.0.1",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.1",
+    "@types/express": "^5.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.10.7",
+    "@types/supertest": "^6.0.2",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.2",
+    "globals": "^16.0.0",
+    "jest": "^30.0.0",
+    "pino-pretty": "^13.1.3",
+    "prettier": "^3.4.2",
+    "rxjs": "^7.8.1",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-jest": "^29.2.5",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0"
+  },
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  }
+}