tpaga-logger 0.0.7 → 0.0.9

package/README.md

@@ -39,50 +39,166 @@ export const handler = withLogger(logger, 'createCharge', async (event, log) =>
 
 ### Express
 
-Use `withTpagaExpressLogger` as a global middleware and `getLog` to access the log context inside route handlers.
+Register two middlewares from the library — one before routes, one after. Both are zero-config.
 
 ```typescript
 import express from 'express';
-import { createLogger, withTpagaExpressLogger, getLog } from 'tpaga-logger';
+import { createLogger, withTpagaExpressLogger, tpagaExpressErrorLogger } from 'tpaga-logger';
+import { errorHandler } from './middleware/errorHandler';
 
-const logger = createLogger({
-  service: 'url-signer-service',
-  environment: process.env.NODE_ENV ?? 'dev',
-});
+const logger = createLogger({ service: 'url-signer-service', environment: process.env.NODE_ENV ?? 'dev' });
 
 const app = express();
 app.use(express.json());
-app.use(withTpagaExpressLogger(logger)); // register once, covers all routes
+app.use(withTpagaExpressLogger(logger)); // before routes: timing, correlationId, req.log
 
-app.post('/api/v1/sign', (req, res) => {
-  req.log.with({ userId: req.body.userId, resource: req.body.resource });
+app.use('/api/v1/sign', signRouter);
 
-  const url = signUrl(req.body);
-  res.json({ url });
-  // terminal log is emitted automatically on res.finish
-});
+app.use(tpagaExpressErrorLogger);        // after routes: serialize + log any error
+app.use(errorHandler);                   // after routes: map error → HTTP response (your code)
 ```
 
+> Express error middleware must be registered **after** routes — this is an Express constraint.
+
 **What `withTpagaExpressLogger` does automatically:**
-- Extracts `correlationId` from headers (generates a UUID if absent)
-- Attaches a typed `WideEventBuilder` to `req.log` (available in all route handlers)
+- Extracts `correlationId` from `x-correlation-id` / `x-request-id` headers (generates UUID if absent)
+- Attaches a typed `WideEventBuilder` to `req.log` and `res.log`
+- Emits `outcome: "success"` for `statusCode < 400`, `outcome: "error"` otherwise
+- Calculates `durationMs` — always matches the actual response time
+
+**What `tpagaExpressErrorLogger` does automatically:**
+- Serializes the error via `serializeError` — no stack, structured `errorDetails` for Zod-like errors
+- Adds `error` to the log context via `req.log.with({ error })`
+- Calls `next(err)` to pass the error to your `errorHandler`
+
+**`req.log` / `res.log` in controllers:**
+
+`req.log` is available anywhere in the request lifecycle — no import needed:
+
+```typescript
+export const signUrl = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const input = signUrlSchema.parse(req.body);
+    req.log.with({ url: input.url, ttlSeconds: input.ttlSeconds });
+    res.status(200).json(generateSignedUrl(input));
+  } catch (err) {
+    req.log.with({ attemptedUrl: req.body?.url, stage: 'signing' }); // extra context on error
+    next(err);
+  }
+};
+```
+
+`res.log` works the same — useful in error handler middleware where `req` params are prefixed with `_`.
+
+**`statusCode` in the log always matches the HTTP response** — it's read from `res.statusCode` after the response is sent.
+
+**`serializeError` output:**
+
+| Error type | `type` | `message` | `errorDetails` |
+|-----------|--------|-----------|----------------|
+| ZodError | `ZodError` | `Validation failed` | array of Zod issues |
+| AppError / Error | `Error` | original message | — |
+| Unknown | `UnknownError` | `String(err)` | — |
+
+---
+
+### NestJS + Fastify <sup>v0.0.9+</sup>
+
+Import from `tpaga-logger/fastify`. Register the plugin and the global interceptor — both are zero-config.
+
+```typescript
+// app.module.ts
+import { Module } from '@nestjs/common';
+import { TpagaLoggerModule } from 'tpaga-logger/fastify';
+
+@Module({
+  imports: [
+    TpagaLoggerModule.forRoot({
+      service: process.env.SERVICE_NAME ?? 'my-service',
+      environment: process.env.NODE_ENV ?? 'dev',
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+```typescript
+// main.ts
+import { NestFactory } from '@nestjs/core';
+import { FastifyAdapter, NestFastifyApplication } from '@nestjs/platform-fastify';
+import { withTpagaFastifyLogger, TpagaLoggerInterceptor, TPAGA_LOGGER } from 'tpaga-logger/fastify';
+import type { Logger } from 'tpaga-logger';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter());
+
+  const logger = app.get<Logger>(TPAGA_LOGGER);
+  await app.register(withTpagaFastifyLogger(logger)); // before routes: timing, correlationId, request.tpagaLog
+  app.useGlobalInterceptors(new TpagaLoggerInterceptor()); // catch errors before exception filters
+
+  await app.listen(3000, '0.0.0.0');
+}
+bootstrap();
+```
+
+**What `withTpagaFastifyLogger` does automatically:**
+- Extracts `correlationId` from `x-correlation-id` / `x-request-id` headers (generates UUID if absent)
+- Attaches a typed `WideEventBuilder` to `request.tpagaLog`
 - Emits `outcome: "success"` for `statusCode < 400`, `outcome: "error"` otherwise
-- Calculates `durationMs` from when the request entered the middleware
+- Calculates `durationMs` — always matches the actual response time
+
+**What `TpagaLoggerInterceptor` does automatically:**
+- Wraps every route handler and catches thrown exceptions before NestJS exception filters run
+- Serializes the error via `serializeError` and adds it to the log context via `request.tpagaLog.with({ error })`
+- Re-throws so NestJS exception handling continues normally
+
+> Use `request.tpagaLog` (not `request.log`) — Fastify already attaches its own pino logger to `request.log`.
+
+**`request.tpagaLog` in controllers:**
+
+```typescript
+import { Controller, Get, Param, Req } from '@nestjs/common';
+import type { FastifyRequest } from 'fastify';
+
+@Controller('charges')
+export class ChargesController {
+  @Get(':id')
+  async getCharge(@Req() req: FastifyRequest, @Param('id') id: string) {
+    req.tpagaLog.with({ chargeId: id });
+    const charge = await this.chargesService.findById(id);
+    req.tpagaLog.with({ merchantId: charge.merchantId });
+    return charge;
+  }
+}
+```
 
 ---
 
 ## API
 
+**`tpaga-logger`** (Express + Lambda)
+
 | Export | Description |
 |--------|-------------|
 | `createLogger(config)` | Creates a logger instance for a service |
 | `withLogger(logger, name, handler)` | Lambda handler wrapper |
 | `withTpagaExpressLogger(logger)` | Express middleware (register with `app.use`) |
+| `tpagaExpressErrorLogger` | Express error middleware (register after routes) |
 | `getLog(res)` | Gets the `WideEventBuilder` from an Express response |
 | `serializeError(err)` | Serializes an unknown error to a structured object |
 | `LOG_LEVELS` | `['info', 'warn', 'error', 'debug']` |
 | `OUTCOMES` | `['success', 'error', 'validation_failed', ...]` |
 
+**`tpaga-logger/fastify`** (NestJS + Fastify)
+
+| Export | Description |
+|--------|-------------|
+| `withTpagaFastifyLogger(logger)` | Fastify plugin — register with `app.register()` |
+| `TpagaLoggerInterceptor` | NestJS interceptor — register with `app.useGlobalInterceptors()` |
+| `TpagaLoggerModule` | NestJS dynamic module — import in `AppModule` |
+| `TPAGA_LOGGER` | Injection token to retrieve the `Logger` instance via DI |
+
 ### `LoggerConfig`
 
 ```typescript

package/dist/fastify.cjs

@@ -0,0 +1,198 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __decoratorStart = (base) => [, , , __create(base?.[__knownSymbol("metadata")] ?? null)];
+var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
+var __expectFn = (fn) => fn !== void 0 && typeof fn !== "function" ? __typeError("Function expected") : fn;
+var __decoratorContext = (kind, name, done, metadata, fns) => ({ kind: __decoratorStrings[kind], name, metadata, addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null)) });
+var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
+var __runInitializers = (array, flags, self, value) => {
+  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length; i < n; i++) flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
+  return value;
+};
+var __decorateElement = (array, flags, name, decorators, target, extra) => {
+  var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
+  var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
+  var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
+  var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : { get [name]() {
+    return __privateGet(this, extra);
+  }, set [name](x) {
+    return __privateSet(this, extra, x);
+  } }, name));
+  k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
+  for (var i = decorators.length - 1; i >= 0; i--) {
+    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
+    if (k) {
+      ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => name in x };
+      if (k ^ 3) access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
+      if (k > 2) access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
+    }
+    it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? void 0 : { get: desc.get, set: desc.set } : target, ctx), done._ = 1;
+    if (k ^ 4 || it === void 0) __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
+    else if (typeof it !== "object" || it === null) __typeError("Object expected");
+    else __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
+  }
+  return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+// src/fastify.ts
+var fastify_exports = {};
+__export(fastify_exports, {
+  TPAGA_LOGGER: () => TPAGA_LOGGER,
+  TpagaLoggerInterceptor: () => TpagaLoggerInterceptor,
+  TpagaLoggerModule: () => TpagaLoggerModule,
+  withTpagaFastifyLogger: () => withTpagaFastifyLogger
+});
+module.exports = __toCommonJS(fastify_exports);
+var import_rxjs = require("rxjs");
+var import_fastify_plugin = __toESM(require("fastify-plugin"), 1);
+var import_common = require("@nestjs/common");
+
+// src/logger.ts
+var import_pino = __toESM(require("pino"), 1);
+
+// src/utils.ts
+var import_crypto = require("crypto");
+var resolveCorrelationId = (headers = {}) => {
+  const h = Object.fromEntries(
+    Object.entries(headers).map(([k, v]) => [k.toLowerCase(), Array.isArray(v) ? v[0] : v])
+  );
+  return h["x-correlation-id"] ?? h["x-request-id"] ?? (0, import_crypto.randomUUID)();
+};
+
+// src/logger.ts
+var serializeError = (err) => {
+  if (!(err instanceof Error)) return { type: "UnknownError", message: String(err) };
+  const errorDetails = err.issues;
+  return {
+    type: err.name,
+    message: errorDetails != null ? "Validation failed" : err.message,
+    code: err.code,
+    errorDetails
+  };
+};
+var createWideEventBuilder = (base, log) => {
+  const ctx = { ...base };
+  return {
+    with: (fields) => Object.assign(ctx, fields),
+    emit: (level, message, terminal) => log[level]({ ...ctx, ...terminal }, message)
+  };
+};
+var createLogger = (config) => {
+  const pretty = process.env.LOG_PRETTY === "true";
+  const log = (0, import_pino.default)({
+    level: process.env.LOG_LEVEL ?? "info",
+    base: { service: config.service, environment: config.environment },
+    formatters: {
+      level: (label) => ({ level: label })
+    },
+    timestamp: import_pino.default.stdTimeFunctions.isoTime,
+    redact: {
+      paths: config.redactKeys ?? [],
+      censor: "[REDACTED]"
+    },
+    ...pretty ? { transport: { target: "pino-pretty", options: { colorize: true } } } : {}
+  });
+  return {
+    startOperation: (functionName, base = {}) => createWideEventBuilder({ function: functionName, ...base }, log)
+  };
+};
+
+// src/fastify.ts
+var START_KEY = /* @__PURE__ */ Symbol("tpagaStart");
+var withTpagaFastifyLogger = (logger) => (0, import_fastify_plugin.default)(async (fastify) => {
+  fastify.addHook("onRequest", (request, _reply, done) => {
+    const correlationId = resolveCorrelationId(request.headers);
+    request.tpagaLog = logger.startOperation(request.url, {
+      correlationId,
+      method: request.method
+    });
+    request[START_KEY] = Date.now();
+    done();
+  });
+  fastify.addHook("onResponse", (request, reply, done) => {
+    const start = request[START_KEY];
+    request.tpagaLog.emit("info", "request completed", {
+      outcome: reply.statusCode < 400 ? "success" : "error",
+      durationMs: Date.now() - start,
+      statusCode: reply.statusCode
+    });
+    done();
+  });
+  fastify.addHook("onError", (request, _reply, error, done) => {
+    request.tpagaLog.with({ error: serializeError(error) });
+    done();
+  });
+});
+var _TpagaLoggerInterceptor_decorators, _init;
+_TpagaLoggerInterceptor_decorators = [(0, import_common.Injectable)()];
+var TpagaLoggerInterceptor = class {
+  intercept(context, next) {
+    return next.handle().pipe(
+      (0, import_rxjs.catchError)((error) => {
+        const request = context.switchToHttp().getRequest();
+        request.tpagaLog?.with({ error: serializeError(error) });
+        return (0, import_rxjs.throwError)(() => error);
+      })
+    );
+  }
+};
+_init = __decoratorStart(null);
+TpagaLoggerInterceptor = __decorateElement(_init, 0, "TpagaLoggerInterceptor", _TpagaLoggerInterceptor_decorators, TpagaLoggerInterceptor);
+__runInitializers(_init, 1, TpagaLoggerInterceptor);
+var TPAGA_LOGGER = "TPAGA_LOGGER";
+var TpagaLoggerModule = class _TpagaLoggerModule {
+  static forRoot(config) {
+    const logger = createLogger(config);
+    return {
+      module: _TpagaLoggerModule,
+      global: true,
+      providers: [{ provide: TPAGA_LOGGER, useValue: logger }],
+      exports: [TPAGA_LOGGER]
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TPAGA_LOGGER,
+  TpagaLoggerInterceptor,
+  TpagaLoggerModule,
+  withTpagaFastifyLogger
+});
+//# sourceMappingURL=fastify.cjs.map

package/dist/fastify.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fastify.ts","../src/logger.ts","../src/utils.ts"],"sourcesContent":["import { catchError, throwError } from 'rxjs';\nimport type { Observable } from 'rxjs';\nimport fp from 'fastify-plugin';\nimport type { FastifyInstance, FastifyRequest } from 'fastify';\nimport type { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';\nimport { Injectable } from '@nestjs/common';\nimport { createLogger, serializeError } from './logger.js';\nimport { resolveCorrelationId } from './utils.js';\nimport type { Logger, LoggerConfig, WideEventBuilder } from './types.js';\n\ndeclare module 'fastify' {\n  interface FastifyRequest {\n    tpagaLog: WideEventBuilder;\n  }\n}\n\nconst START_KEY = Symbol('tpagaStart');\n\nexport const withTpagaFastifyLogger = (logger: Logger) =>\n  fp(async (fastify: FastifyInstance): Promise<void> => {\n    fastify.addHook('onRequest', (request, _reply, done) => {\n      const correlationId = resolveCorrelationId(request.headers);\n      request.tpagaLog = logger.startOperation(request.url, {\n        correlationId,\n        method: request.method,\n      });\n      (request as unknown as Record<symbol, number>)[START_KEY] = Date.now();\n      done();\n    });\n\n    fastify.addHook('onResponse', (request, reply, done) => {\n      const start = (request as unknown as Record<symbol, number>)[START_KEY];\n      request.tpagaLog.emit('info', 'request completed', {\n        outcome: reply.statusCode < 400 ? 'success' : 'error',\n        durationMs: Date.now() - start,\n        statusCode: reply.statusCode,\n      });\n      done();\n    });\n\n    fastify.addHook('onError', (request, _reply, error, done) => {\n      request.tpagaLog.with({ error: serializeError(error) });\n      done();\n    });\n  });\n\n@Injectable()\nexport class TpagaLoggerInterceptor implements NestInterceptor {\n  intercept(context: ExecutionContext, next: CallHandler): Observable<unknown> {\n    return next.handle().pipe(\n      catchError((error: unknown) => {\n        const request = context.switchToHttp().getRequest<FastifyRequest>();\n        request.tpagaLog?.with({ error: serializeError(error) });\n        return throwError(() => error);\n      }),\n    );\n  }\n}\n\nexport const TPAGA_LOGGER = 'TPAGA_LOGGER' as const;\n\nexport class TpagaLoggerModule {\n  static forRoot(config: LoggerConfig) {\n    const logger = createLogger(config);\n    return {\n      module: TpagaLoggerModule,\n      global: true,\n      providers: [{ provide: TPAGA_LOGGER, useValue: logger }],\n      exports: [TPAGA_LOGGER],\n    };\n  }\n}\n","import pino from 'pino';\nimport type { NextFunction, Request, Response } from 'express';\nimport type { Logger, LoggerConfig, SerializedError, TerminalFields, WideEventBuilder } from './types.js';\nimport { resolveCorrelationId } from './utils.js';\n\ndeclare global {\n  namespace Express {\n    interface Request {\n      log: WideEventBuilder;\n    }\n    interface Response {\n      log: WideEventBuilder;\n    }\n  }\n}\n\nexport const serializeError = (err: unknown): SerializedError => {\n  if (!(err instanceof Error)) return { type: 'UnknownError', message: String(err) };\n  const errorDetails = (err as { issues?: unknown }).issues;\n  return {\n    type: err.name,\n    message: errorDetails != null ? 'Validation failed' : err.message,\n    code: (err as { code?: string }).code,\n    errorDetails,\n  };\n};\n\nconst createWideEventBuilder = (\n  base: Record<string, unknown>,\n  log: pino.Logger,\n): WideEventBuilder => {\n  const ctx = { ...base };\n  return {\n    with: (fields) => Object.assign(ctx, fields),\n    emit: (level, message, terminal: TerminalFields) => log[level]({ ...ctx, ...terminal }, message),\n  };\n};\n\nexport const createLogger = (config: LoggerConfig): Logger => {\n  const pretty = process.env.LOG_PRETTY === 'true';\n  const log = pino({\n    level: process.env.LOG_LEVEL ?? 'info',\n    base: { service: config.service, environment: config.environment },\n    formatters: {\n      level: (label) => ({ level: label }),\n    },\n    timestamp: pino.stdTimeFunctions.isoTime,\n    redact: {\n      paths: (config.redactKeys as string[]) ?? [],\n      censor: '[REDACTED]',\n    },\n    ...(pretty ? { transport: { target: 'pino-pretty', options: { colorize: true } } } : {}),\n  });\n\n  return {\n    startOperation: (functionName, base = {}) =>\n      createWideEventBuilder({ function: functionName, ...base }, log),\n  };\n};\n\ntype EventWithHeaders = { headers?: Record<string, string | undefined> };\ntype HandlerWithBuilder<TEvent> = (event: TEvent, builder: WideEventBuilder) => Promise<unknown>;\n\nconst EXPRESS_LOG_KEY = 'tpagaLog';\n\nexport const withTpagaExpressLogger = (logger: Logger) =>\n  (req: Request, res: Response, next: NextFunction): void => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(req.headers as Record<string, string | undefined>);\n    const log = logger.startOperation(req.path, { correlationId, method: req.method });\n\n    req.log = log;\n    res.log = log;\n    res.locals[EXPRESS_LOG_KEY] = log;\n\n    res.on('finish', () => {\n      log.emit('info', 'request completed', {\n        outcome: res.statusCode < 400 ? 'success' : 'error',\n        durationMs: Date.now() - start,\n        statusCode: res.statusCode,\n      });\n    });\n\n    next();\n  };\n\nexport const tpagaExpressErrorLogger = (err: unknown, req: Request, _res: Response, next: NextFunction): void => {\n  req.log.with({ error: serializeError(err) });\n  next(err);\n};\n\nexport const getLog = (res: Response): WideEventBuilder =>\n  res.locals[EXPRESS_LOG_KEY] as WideEventBuilder;\n\nexport const withLogger = <TEvent extends EventWithHeaders>(\n  logger: Logger,\n  operationName: string,\n  handler: HandlerWithBuilder<TEvent>,\n) =>\n  async (event: TEvent, ..._rest: unknown[]): Promise<unknown> => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(event.headers);\n    const builder = logger.startOperation(operationName, { correlationId });\n\n    try {\n      const result = await handler(event, builder);\n      const statusCode =\n        result != null &&\n        typeof result === 'object' &&\n        'statusCode' in result &&\n        typeof (result as { statusCode: unknown }).statusCode === 'number'\n          ? (result as { statusCode: number }).statusCode\n          : undefined;\n      builder.emit('info', `${operationName} completed`, {\n        outcome: 'success',\n        durationMs: Date.now() - start,\n        ...(statusCode !== undefined ? { statusCode } : {}),\n      });\n      return result;\n    } catch (err) {\n      builder.emit('error', `${operationName} failed`, {\n        outcome: 'error',\n        durationMs: Date.now() - start,\n        error: serializeError(err),\n      });\n      throw err;\n    }\n  };\n","import { randomUUID } from 'crypto';\n\nexport const resolveCorrelationId = (\n  headers: Record<string, string | string[] | undefined> = {},\n): string => {\n  const h = Object.fromEntries(\n    Object.entries(headers).map(([k, v]) => [k.toLowerCase(), Array.isArray(v) ? v[0] : v]),\n  );\n  return h['x-correlation-id'] ?? h['x-request-id'] ?? randomUUID();\n};\n"],"mappings":"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","names":["pino","fp"]}

package/dist/fastify.d.cts

@@ -0,0 +1,28 @@
+import { Observable } from 'rxjs';
+import { FastifyInstance } from 'fastify';
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { W as WideEventBuilder, c as LoggerConfig, b as Logger } from './types-BtTFSWeZ.cjs';
+
+declare module 'fastify' {
+    interface FastifyRequest {
+        tpagaLog: WideEventBuilder;
+    }
+}
+declare const withTpagaFastifyLogger: (logger: Logger) => (fastify: FastifyInstance) => Promise<void>;
+declare class TpagaLoggerInterceptor implements NestInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+declare const TPAGA_LOGGER: "TPAGA_LOGGER";
+declare class TpagaLoggerModule {
+    static forRoot(config: LoggerConfig): {
+        module: typeof TpagaLoggerModule;
+        global: boolean;
+        providers: {
+            provide: "TPAGA_LOGGER";
+            useValue: Logger;
+        }[];
+        exports: "TPAGA_LOGGER"[];
+    };
+}
+
+export { TPAGA_LOGGER, TpagaLoggerInterceptor, TpagaLoggerModule, withTpagaFastifyLogger };

package/dist/fastify.d.ts

@@ -0,0 +1,28 @@
+import { Observable } from 'rxjs';
+import { FastifyInstance } from 'fastify';
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { W as WideEventBuilder, c as LoggerConfig, b as Logger } from './types-BtTFSWeZ.js';
+
+declare module 'fastify' {
+    interface FastifyRequest {
+        tpagaLog: WideEventBuilder;
+    }
+}
+declare const withTpagaFastifyLogger: (logger: Logger) => (fastify: FastifyInstance) => Promise<void>;
+declare class TpagaLoggerInterceptor implements NestInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+declare const TPAGA_LOGGER: "TPAGA_LOGGER";
+declare class TpagaLoggerModule {
+    static forRoot(config: LoggerConfig): {
+        module: typeof TpagaLoggerModule;
+        global: boolean;
+        providers: {
+            provide: "TPAGA_LOGGER";
+            useValue: Logger;
+        }[];
+        exports: "TPAGA_LOGGER"[];
+    };
+}
+
+export { TPAGA_LOGGER, TpagaLoggerInterceptor, TpagaLoggerModule, withTpagaFastifyLogger };

package/dist/fastify.js

@@ -0,0 +1,164 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __decoratorStart = (base) => [, , , __create(base?.[__knownSymbol("metadata")] ?? null)];
+var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
+var __expectFn = (fn) => fn !== void 0 && typeof fn !== "function" ? __typeError("Function expected") : fn;
+var __decoratorContext = (kind, name, done, metadata, fns) => ({ kind: __decoratorStrings[kind], name, metadata, addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null)) });
+var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
+var __runInitializers = (array, flags, self, value) => {
+  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length; i < n; i++) flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
+  return value;
+};
+var __decorateElement = (array, flags, name, decorators, target, extra) => {
+  var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
+  var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
+  var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
+  var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : { get [name]() {
+    return __privateGet(this, extra);
+  }, set [name](x) {
+    return __privateSet(this, extra, x);
+  } }, name));
+  k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
+  for (var i = decorators.length - 1; i >= 0; i--) {
+    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
+    if (k) {
+      ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => name in x };
+      if (k ^ 3) access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
+      if (k > 2) access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
+    }
+    it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? void 0 : { get: desc.get, set: desc.set } : target, ctx), done._ = 1;
+    if (k ^ 4 || it === void 0) __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
+    else if (typeof it !== "object" || it === null) __typeError("Object expected");
+    else __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
+  }
+  return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+// src/fastify.ts
+import { catchError, throwError } from "rxjs";
+import fp from "fastify-plugin";
+import { Injectable } from "@nestjs/common";
+
+// src/logger.ts
+import pino from "pino";
+
+// src/utils.ts
+import { randomUUID } from "crypto";
+var resolveCorrelationId = (headers = {}) => {
+  const h = Object.fromEntries(
+    Object.entries(headers).map(([k, v]) => [k.toLowerCase(), Array.isArray(v) ? v[0] : v])
+  );
+  return h["x-correlation-id"] ?? h["x-request-id"] ?? randomUUID();
+};
+
+// src/logger.ts
+var serializeError = (err) => {
+  if (!(err instanceof Error)) return { type: "UnknownError", message: String(err) };
+  const errorDetails = err.issues;
+  return {
+    type: err.name,
+    message: errorDetails != null ? "Validation failed" : err.message,
+    code: err.code,
+    errorDetails
+  };
+};
+var createWideEventBuilder = (base, log) => {
+  const ctx = { ...base };
+  return {
+    with: (fields) => Object.assign(ctx, fields),
+    emit: (level, message, terminal) => log[level]({ ...ctx, ...terminal }, message)
+  };
+};
+var createLogger = (config) => {
+  const pretty = process.env.LOG_PRETTY === "true";
+  const log = pino({
+    level: process.env.LOG_LEVEL ?? "info",
+    base: { service: config.service, environment: config.environment },
+    formatters: {
+      level: (label) => ({ level: label })
+    },
+    timestamp: pino.stdTimeFunctions.isoTime,
+    redact: {
+      paths: config.redactKeys ?? [],
+      censor: "[REDACTED]"
+    },
+    ...pretty ? { transport: { target: "pino-pretty", options: { colorize: true } } } : {}
+  });
+  return {
+    startOperation: (functionName, base = {}) => createWideEventBuilder({ function: functionName, ...base }, log)
+  };
+};
+
+// src/fastify.ts
+var START_KEY = /* @__PURE__ */ Symbol("tpagaStart");
+var withTpagaFastifyLogger = (logger) => fp(async (fastify) => {
+  fastify.addHook("onRequest", (request, _reply, done) => {
+    const correlationId = resolveCorrelationId(request.headers);
+    request.tpagaLog = logger.startOperation(request.url, {
+      correlationId,
+      method: request.method
+    });
+    request[START_KEY] = Date.now();
+    done();
+  });
+  fastify.addHook("onResponse", (request, reply, done) => {
+    const start = request[START_KEY];
+    request.tpagaLog.emit("info", "request completed", {
+      outcome: reply.statusCode < 400 ? "success" : "error",
+      durationMs: Date.now() - start,
+      statusCode: reply.statusCode
+    });
+    done();
+  });
+  fastify.addHook("onError", (request, _reply, error, done) => {
+    request.tpagaLog.with({ error: serializeError(error) });
+    done();
+  });
+});
+var _TpagaLoggerInterceptor_decorators, _init;
+_TpagaLoggerInterceptor_decorators = [Injectable()];
+var TpagaLoggerInterceptor = class {
+  intercept(context, next) {
+    return next.handle().pipe(
+      catchError((error) => {
+        const request = context.switchToHttp().getRequest();
+        request.tpagaLog?.with({ error: serializeError(error) });
+        return throwError(() => error);
+      })
+    );
+  }
+};
+_init = __decoratorStart(null);
+TpagaLoggerInterceptor = __decorateElement(_init, 0, "TpagaLoggerInterceptor", _TpagaLoggerInterceptor_decorators, TpagaLoggerInterceptor);
+__runInitializers(_init, 1, TpagaLoggerInterceptor);
+var TPAGA_LOGGER = "TPAGA_LOGGER";
+var TpagaLoggerModule = class _TpagaLoggerModule {
+  static forRoot(config) {
+    const logger = createLogger(config);
+    return {
+      module: _TpagaLoggerModule,
+      global: true,
+      providers: [{ provide: TPAGA_LOGGER, useValue: logger }],
+      exports: [TPAGA_LOGGER]
+    };
+  }
+};
+export {
+  TPAGA_LOGGER,
+  TpagaLoggerInterceptor,
+  TpagaLoggerModule,
+  withTpagaFastifyLogger
+};
+//# sourceMappingURL=fastify.js.map

package/dist/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fastify.ts","../src/logger.ts","../src/utils.ts"],"sourcesContent":["import { catchError, throwError } from 'rxjs';\nimport type { Observable } from 'rxjs';\nimport fp from 'fastify-plugin';\nimport type { FastifyInstance, FastifyRequest } from 'fastify';\nimport type { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';\nimport { Injectable } from '@nestjs/common';\nimport { createLogger, serializeError } from './logger.js';\nimport { resolveCorrelationId } from './utils.js';\nimport type { Logger, LoggerConfig, WideEventBuilder } from './types.js';\n\ndeclare module 'fastify' {\n  interface FastifyRequest {\n    tpagaLog: WideEventBuilder;\n  }\n}\n\nconst START_KEY = Symbol('tpagaStart');\n\nexport const withTpagaFastifyLogger = (logger: Logger) =>\n  fp(async (fastify: FastifyInstance): Promise<void> => {\n    fastify.addHook('onRequest', (request, _reply, done) => {\n      const correlationId = resolveCorrelationId(request.headers);\n      request.tpagaLog = logger.startOperation(request.url, {\n        correlationId,\n        method: request.method,\n      });\n      (request as unknown as Record<symbol, number>)[START_KEY] = Date.now();\n      done();\n    });\n\n    fastify.addHook('onResponse', (request, reply, done) => {\n      const start = (request as unknown as Record<symbol, number>)[START_KEY];\n      request.tpagaLog.emit('info', 'request completed', {\n        outcome: reply.statusCode < 400 ? 'success' : 'error',\n        durationMs: Date.now() - start,\n        statusCode: reply.statusCode,\n      });\n      done();\n    });\n\n    fastify.addHook('onError', (request, _reply, error, done) => {\n      request.tpagaLog.with({ error: serializeError(error) });\n      done();\n    });\n  });\n\n@Injectable()\nexport class TpagaLoggerInterceptor implements NestInterceptor {\n  intercept(context: ExecutionContext, next: CallHandler): Observable<unknown> {\n    return next.handle().pipe(\n      catchError((error: unknown) => {\n        const request = context.switchToHttp().getRequest<FastifyRequest>();\n        request.tpagaLog?.with({ error: serializeError(error) });\n        return throwError(() => error);\n      }),\n    );\n  }\n}\n\nexport const TPAGA_LOGGER = 'TPAGA_LOGGER' as const;\n\nexport class TpagaLoggerModule {\n  static forRoot(config: LoggerConfig) {\n    const logger = createLogger(config);\n    return {\n      module: TpagaLoggerModule,\n      global: true,\n      providers: [{ provide: TPAGA_LOGGER, useValue: logger }],\n      exports: [TPAGA_LOGGER],\n    };\n  }\n}\n","import pino from 'pino';\nimport type { NextFunction, Request, Response } from 'express';\nimport type { Logger, LoggerConfig, SerializedError, TerminalFields, WideEventBuilder } from './types.js';\nimport { resolveCorrelationId } from './utils.js';\n\ndeclare global {\n  namespace Express {\n    interface Request {\n      log: WideEventBuilder;\n    }\n    interface Response {\n      log: WideEventBuilder;\n    }\n  }\n}\n\nexport const serializeError = (err: unknown): SerializedError => {\n  if (!(err instanceof Error)) return { type: 'UnknownError', message: String(err) };\n  const errorDetails = (err as { issues?: unknown }).issues;\n  return {\n    type: err.name,\n    message: errorDetails != null ? 'Validation failed' : err.message,\n    code: (err as { code?: string }).code,\n    errorDetails,\n  };\n};\n\nconst createWideEventBuilder = (\n  base: Record<string, unknown>,\n  log: pino.Logger,\n): WideEventBuilder => {\n  const ctx = { ...base };\n  return {\n    with: (fields) => Object.assign(ctx, fields),\n    emit: (level, message, terminal: TerminalFields) => log[level]({ ...ctx, ...terminal }, message),\n  };\n};\n\nexport const createLogger = (config: LoggerConfig): Logger => {\n  const pretty = process.env.LOG_PRETTY === 'true';\n  const log = pino({\n    level: process.env.LOG_LEVEL ?? 'info',\n    base: { service: config.service, environment: config.environment },\n    formatters: {\n      level: (label) => ({ level: label }),\n    },\n    timestamp: pino.stdTimeFunctions.isoTime,\n    redact: {\n      paths: (config.redactKeys as string[]) ?? [],\n      censor: '[REDACTED]',\n    },\n    ...(pretty ? { transport: { target: 'pino-pretty', options: { colorize: true } } } : {}),\n  });\n\n  return {\n    startOperation: (functionName, base = {}) =>\n      createWideEventBuilder({ function: functionName, ...base }, log),\n  };\n};\n\ntype EventWithHeaders = { headers?: Record<string, string | undefined> };\ntype HandlerWithBuilder<TEvent> = (event: TEvent, builder: WideEventBuilder) => Promise<unknown>;\n\nconst EXPRESS_LOG_KEY = 'tpagaLog';\n\nexport const withTpagaExpressLogger = (logger: Logger) =>\n  (req: Request, res: Response, next: NextFunction): void => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(req.headers as Record<string, string | undefined>);\n    const log = logger.startOperation(req.path, { correlationId, method: req.method });\n\n    req.log = log;\n    res.log = log;\n    res.locals[EXPRESS_LOG_KEY] = log;\n\n    res.on('finish', () => {\n      log.emit('info', 'request completed', {\n        outcome: res.statusCode < 400 ? 'success' : 'error',\n        durationMs: Date.now() - start,\n        statusCode: res.statusCode,\n      });\n    });\n\n    next();\n  };\n\nexport const tpagaExpressErrorLogger = (err: unknown, req: Request, _res: Response, next: NextFunction): void => {\n  req.log.with({ error: serializeError(err) });\n  next(err);\n};\n\nexport const getLog = (res: Response): WideEventBuilder =>\n  res.locals[EXPRESS_LOG_KEY] as WideEventBuilder;\n\nexport const withLogger = <TEvent extends EventWithHeaders>(\n  logger: Logger,\n  operationName: string,\n  handler: HandlerWithBuilder<TEvent>,\n) =>\n  async (event: TEvent, ..._rest: unknown[]): Promise<unknown> => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(event.headers);\n    const builder = logger.startOperation(operationName, { correlationId });\n\n    try {\n      const result = await handler(event, builder);\n      const statusCode =\n        result != null &&\n        typeof result === 'object' &&\n        'statusCode' in result &&\n        typeof (result as { statusCode: unknown }).statusCode === 'number'\n          ? (result as { statusCode: number }).statusCode\n          : undefined;\n      builder.emit('info', `${operationName} completed`, {\n        outcome: 'success',\n        durationMs: Date.now() - start,\n        ...(statusCode !== undefined ? { statusCode } : {}),\n      });\n      return result;\n    } catch (err) {\n      builder.emit('error', `${operationName} failed`, {\n        outcome: 'error',\n        durationMs: Date.now() - start,\n        error: serializeError(err),\n      });\n      throw err;\n    }\n  };\n","import { randomUUID } from 'crypto';\n\nexport const resolveCorrelationId = (\n  headers: Record<string, string | string[] | undefined> = {},\n): string => {\n  const h = Object.fromEntries(\n    Object.entries(headers).map(([k, v]) => [k.toLowerCase(), Array.isArray(v) ? v[0] : v]),\n  );\n  return h['x-correlation-id'] ?? h['x-request-id'] ?? randomUUID();\n};\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -42,8 +42,18 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/logger.ts
-var import_crypto = require("crypto");
 var import_pino = __toESM(require("pino"), 1);
+
+// src/utils.ts
+var import_crypto = require("crypto");
+var resolveCorrelationId = (headers = {}) => {
+  const h = Object.fromEntries(
+    Object.entries(headers).map(([k, v]) => [k.toLowerCase(), Array.isArray(v) ? v[0] : v])
+  );
+  return h["x-correlation-id"] ?? h["x-request-id"] ?? (0, import_crypto.randomUUID)();
+};
+
+// src/logger.ts
 var serializeError = (err) => {
   if (!(err instanceof Error)) return { type: "UnknownError", message: String(err) };
   const errorDetails = err.issues;
@@ -80,10 +90,6 @@ var createLogger = (config) => {
     startOperation: (functionName, base = {}) => createWideEventBuilder({ function: functionName, ...base }, log)
   };
 };
-var resolveCorrelationId = (headers = {}) => {
-  const h = Object.fromEntries(Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v]));
-  return h["x-correlation-id"] ?? h["x-request-id"] ?? (0, import_crypto.randomUUID)();
-};
 var EXPRESS_LOG_KEY = "tpagaLog";
 var withTpagaExpressLogger = (logger) => (req, res, next) => {
   const start = Date.now();

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/logger.ts","../src/constants.ts"],"sourcesContent":["export { createLogger, serializeError, withLogger, withTpagaExpressLogger, tpagaExpressErrorLogger, getLog } from './logger.js';\nexport { LOG_LEVELS, OUTCOMES } from './constants.js';\nexport type {\n  Logger,\n  LoggerConfig,\n  LogLevel,\n  Outcome,\n  SerializedError,\n  TerminalFields,\n  WideEventBuilder,\n} from './types.js';\n","import { randomUUID } from 'crypto';\nimport pino from 'pino';\nimport type { NextFunction, Request, Response } from 'express';\nimport type { Logger, LoggerConfig, SerializedError, TerminalFields, WideEventBuilder } from './types.js';\n\ndeclare global {\n  namespace Express {\n    interface Request {\n      log: WideEventBuilder;\n    }\n    interface Response {\n      log: WideEventBuilder;\n    }\n  }\n}\n\nexport const serializeError = (err: unknown): SerializedError => {\n  if (!(err instanceof Error)) return { type: 'UnknownError', message: String(err) };\n  const errorDetails = (err as { issues?: unknown }).issues;\n  return {\n    type: err.name,\n    message: errorDetails != null ? 'Validation failed' : err.message,\n    code: (err as { code?: string }).code,\n    errorDetails,\n  };\n};\n\nconst createWideEventBuilder = (\n  base: Record<string, unknown>,\n  log: pino.Logger,\n): WideEventBuilder => {\n  const ctx = { ...base };\n  return {\n    with: (fields) => Object.assign(ctx, fields),\n    emit: (level, message, terminal: TerminalFields) => log[level]({ ...ctx, ...terminal }, message),\n  };\n};\n\nexport const createLogger = (config: LoggerConfig): Logger => {\n  const pretty = process.env.LOG_PRETTY === 'true';\n  const log = pino({\n    level: process.env.LOG_LEVEL ?? 'info',\n    base: { service: config.service, environment: config.environment },\n    formatters: {\n      level: (label) => ({ level: label }),\n    },\n    timestamp: pino.stdTimeFunctions.isoTime,\n    redact: {\n      paths: (config.redactKeys as string[]) ?? [],\n      censor: '[REDACTED]',\n    },\n    ...(pretty ? { transport: { target: 'pino-pretty', options: { colorize: true } } } : {}),\n  });\n\n  return {\n    startOperation: (functionName, base = {}) =>\n      createWideEventBuilder({ function: functionName, ...base }, log),\n  };\n};\n\ntype EventWithHeaders = { headers?: Record<string, string | undefined> };\ntype HandlerWithBuilder<TEvent> = (event: TEvent, builder: WideEventBuilder) => Promise<unknown>;\n\nconst resolveCorrelationId = (headers: Record<string, string | undefined> = {}): string => {\n  const h = Object.fromEntries(Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v]));\n  return h['x-correlation-id'] ?? h['x-request-id'] ?? randomUUID();\n};\n\nconst EXPRESS_LOG_KEY = 'tpagaLog';\n\nexport const withTpagaExpressLogger = (logger: Logger) =>\n  (req: Request, res: Response, next: NextFunction): void => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(req.headers as Record<string, string | undefined>);\n    const log = logger.startOperation(req.path, { correlationId, method: req.method });\n\n    req.log = log;\n    res.log = log;\n    res.locals[EXPRESS_LOG_KEY] = log;\n\n    res.on('finish', () => {\n      log.emit('info', 'request completed', {\n        outcome: res.statusCode < 400 ? 'success' : 'error',\n        durationMs: Date.now() - start,\n        statusCode: res.statusCode,\n      });\n    });\n\n    next();\n  };\n\nexport const tpagaExpressErrorLogger = (err: unknown, req: Request, _res: Response, next: NextFunction): void => {\n  req.log.with({ error: serializeError(err) });\n  next(err);\n};\n\nexport const getLog = (res: Response): WideEventBuilder =>\n  res.locals[EXPRESS_LOG_KEY] as WideEventBuilder;\n\nexport const withLogger = <TEvent extends EventWithHeaders>(\n  logger: Logger,\n  operationName: string,\n  handler: HandlerWithBuilder<TEvent>,\n) =>\n  async (event: TEvent, ..._rest: unknown[]): Promise<unknown> => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(event.headers);\n    const builder = logger.startOperation(operationName, { correlationId });\n\n    try {\n      const result = await handler(event, builder);\n      const statusCode =\n        result != null &&\n        typeof result === 'object' &&\n        'statusCode' in result &&\n        typeof (result as { statusCode: unknown }).statusCode === 'number'\n          ? (result as { statusCode: number }).statusCode\n          : undefined;\n      builder.emit('info', `${operationName} completed`, {\n        outcome: 'success',\n        durationMs: Date.now() - start,\n        ...(statusCode !== undefined ? { statusCode } : {}),\n      });\n      return result;\n    } catch (err) {\n      builder.emit('error', `${operationName} failed`, {\n        outcome: 'error',\n        durationMs: Date.now() - start,\n        error: serializeError(err),\n      });\n      throw err;\n    }\n  };\n","export const LOG_LEVELS = ['info', 'warn', 'error', 'debug'] as const;\n\nexport const OUTCOMES = [\n  'success',\n  'error',\n  'validation_failed',\n  'not_found',\n  'conflict',\n  'timeout',\n  'skipped',\n] as const;\n"],"mappings":"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","names":["pino"]}
+{"version":3,"sources":["../src/index.ts","../src/logger.ts","../src/utils.ts","../src/constants.ts"],"sourcesContent":["export { createLogger, serializeError, withLogger, withTpagaExpressLogger, tpagaExpressErrorLogger, getLog } from './logger.js';\nexport { LOG_LEVELS, OUTCOMES } from './constants.js';\nexport type {\n  Logger,\n  LoggerConfig,\n  LogLevel,\n  Outcome,\n  SerializedError,\n  TerminalFields,\n  WideEventBuilder,\n} from './types.js';\n","import pino from 'pino';\nimport type { NextFunction, Request, Response } from 'express';\nimport type { Logger, LoggerConfig, SerializedError, TerminalFields, WideEventBuilder } from './types.js';\nimport { resolveCorrelationId } from './utils.js';\n\ndeclare global {\n  namespace Express {\n    interface Request {\n      log: WideEventBuilder;\n    }\n    interface Response {\n      log: WideEventBuilder;\n    }\n  }\n}\n\nexport const serializeError = (err: unknown): SerializedError => {\n  if (!(err instanceof Error)) return { type: 'UnknownError', message: String(err) };\n  const errorDetails = (err as { issues?: unknown }).issues;\n  return {\n    type: err.name,\n    message: errorDetails != null ? 'Validation failed' : err.message,\n    code: (err as { code?: string }).code,\n    errorDetails,\n  };\n};\n\nconst createWideEventBuilder = (\n  base: Record<string, unknown>,\n  log: pino.Logger,\n): WideEventBuilder => {\n  const ctx = { ...base };\n  return {\n    with: (fields) => Object.assign(ctx, fields),\n    emit: (level, message, terminal: TerminalFields) => log[level]({ ...ctx, ...terminal }, message),\n  };\n};\n\nexport const createLogger = (config: LoggerConfig): Logger => {\n  const pretty = process.env.LOG_PRETTY === 'true';\n  const log = pino({\n    level: process.env.LOG_LEVEL ?? 'info',\n    base: { service: config.service, environment: config.environment },\n    formatters: {\n      level: (label) => ({ level: label }),\n    },\n    timestamp: pino.stdTimeFunctions.isoTime,\n    redact: {\n      paths: (config.redactKeys as string[]) ?? [],\n      censor: '[REDACTED]',\n    },\n    ...(pretty ? { transport: { target: 'pino-pretty', options: { colorize: true } } } : {}),\n  });\n\n  return {\n    startOperation: (functionName, base = {}) =>\n      createWideEventBuilder({ function: functionName, ...base }, log),\n  };\n};\n\ntype EventWithHeaders = { headers?: Record<string, string | undefined> };\ntype HandlerWithBuilder<TEvent> = (event: TEvent, builder: WideEventBuilder) => Promise<unknown>;\n\nconst EXPRESS_LOG_KEY = 'tpagaLog';\n\nexport const withTpagaExpressLogger = (logger: Logger) =>\n  (req: Request, res: Response, next: NextFunction): void => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(req.headers as Record<string, string | undefined>);\n    const log = logger.startOperation(req.path, { correlationId, method: req.method });\n\n    req.log = log;\n    res.log = log;\n    res.locals[EXPRESS_LOG_KEY] = log;\n\n    res.on('finish', () => {\n      log.emit('info', 'request completed', {\n        outcome: res.statusCode < 400 ? 'success' : 'error',\n        durationMs: Date.now() - start,\n        statusCode: res.statusCode,\n      });\n    });\n\n    next();\n  };\n\nexport const tpagaExpressErrorLogger = (err: unknown, req: Request, _res: Response, next: NextFunction): void => {\n  req.log.with({ error: serializeError(err) });\n  next(err);\n};\n\nexport const getLog = (res: Response): WideEventBuilder =>\n  res.locals[EXPRESS_LOG_KEY] as WideEventBuilder;\n\nexport const withLogger = <TEvent extends EventWithHeaders>(\n  logger: Logger,\n  operationName: string,\n  handler: HandlerWithBuilder<TEvent>,\n) =>\n  async (event: TEvent, ..._rest: unknown[]): Promise<unknown> => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(event.headers);\n    const builder = logger.startOperation(operationName, { correlationId });\n\n    try {\n      const result = await handler(event, builder);\n      const statusCode =\n        result != null &&\n        typeof result === 'object' &&\n        'statusCode' in result &&\n        typeof (result as { statusCode: unknown }).statusCode === 'number'\n          ? (result as { statusCode: number }).statusCode\n          : undefined;\n      builder.emit('info', `${operationName} completed`, {\n        outcome: 'success',\n        durationMs: Date.now() - start,\n        ...(statusCode !== undefined ? { statusCode } : {}),\n      });\n      return result;\n    } catch (err) {\n      builder.emit('error', `${operationName} failed`, {\n        outcome: 'error',\n        durationMs: Date.now() - start,\n        error: serializeError(err),\n      });\n      throw err;\n    }\n  };\n","import { randomUUID } from 'crypto';\n\nexport const resolveCorrelationId = (\n  headers: Record<string, string | string[] | undefined> = {},\n): string => {\n  const h = Object.fromEntries(\n    Object.entries(headers).map(([k, v]) => [k.toLowerCase(), Array.isArray(v) ? v[0] : v]),\n  );\n  return h['x-correlation-id'] ?? h['x-request-id'] ?? randomUUID();\n};\n","export const LOG_LEVELS = ['info', 'warn', 'error', 'debug'] as const;\n\nexport const OUTCOMES = [\n  'success',\n  'error',\n  'validation_failed',\n  'not_found',\n  'conflict',\n  'timeout',\n  'skipped',\n] as const;\n"],"mappings":"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","names":["pino"]}

package/dist/index.d.cts

@@ -1,34 +1,6 @@
 import { Response, Request, NextFunction } from 'express';
-
-declare const LOG_LEVELS: readonly ["info", "warn", "error", "debug"];
-declare const OUTCOMES: readonly ["success", "error", "validation_failed", "not_found", "conflict", "timeout", "skipped"];
-
-type LogLevel = (typeof LOG_LEVELS)[number];
-type Outcome = (typeof OUTCOMES)[number];
-type LoggerConfig = {
-    service: string;
-    environment?: string;
-    redactKeys?: readonly string[];
-};
-type SerializedError = {
-    type: string;
-    message: string;
-    code?: string;
-    errorDetails?: unknown;
-};
-type TerminalFields = {
-    outcome: Outcome | string;
-    durationMs: number;
-    statusCode?: number;
-    error?: SerializedError;
-};
-type WideEventBuilder = {
-    with: (fields: Record<string, unknown>) => void;
-    emit: (level: LogLevel, message: string, terminal: TerminalFields) => void;
-};
-type Logger = {
-    startOperation: (functionName: string, base?: Record<string, unknown>) => WideEventBuilder;
-};
+import { W as WideEventBuilder, c as LoggerConfig, b as Logger, S as SerializedError } from './types-BtTFSWeZ.cjs';
+export { L as LOG_LEVELS, a as LogLevel, O as OUTCOMES, d as Outcome, T as TerminalFields } from './types-BtTFSWeZ.cjs';
 
 declare global {
     namespace Express {
@@ -51,4 +23,4 @@ declare const tpagaExpressErrorLogger: (err: unknown, req: Request, _res: Respon
 declare const getLog: (res: Response) => WideEventBuilder;
 declare const withLogger: <TEvent extends EventWithHeaders>(logger: Logger, operationName: string, handler: HandlerWithBuilder<TEvent>) => (event: TEvent, ..._rest: unknown[]) => Promise<unknown>;
 
-export { LOG_LEVELS, type LogLevel, type Logger, type LoggerConfig, OUTCOMES, type Outcome, type SerializedError, type TerminalFields, type WideEventBuilder, createLogger, getLog, serializeError, tpagaExpressErrorLogger, withLogger, withTpagaExpressLogger };
+export { Logger, LoggerConfig, SerializedError, WideEventBuilder, createLogger, getLog, serializeError, tpagaExpressErrorLogger, withLogger, withTpagaExpressLogger };

package/dist/index.d.ts

@@ -1,34 +1,6 @@
 import { Response, Request, NextFunction } from 'express';
-
-declare const LOG_LEVELS: readonly ["info", "warn", "error", "debug"];
-declare const OUTCOMES: readonly ["success", "error", "validation_failed", "not_found", "conflict", "timeout", "skipped"];
-
-type LogLevel = (typeof LOG_LEVELS)[number];
-type Outcome = (typeof OUTCOMES)[number];
-type LoggerConfig = {
-    service: string;
-    environment?: string;
-    redactKeys?: readonly string[];
-};
-type SerializedError = {
-    type: string;
-    message: string;
-    code?: string;
-    errorDetails?: unknown;
-};
-type TerminalFields = {
-    outcome: Outcome | string;
-    durationMs: number;
-    statusCode?: number;
-    error?: SerializedError;
-};
-type WideEventBuilder = {
-    with: (fields: Record<string, unknown>) => void;
-    emit: (level: LogLevel, message: string, terminal: TerminalFields) => void;
-};
-type Logger = {
-    startOperation: (functionName: string, base?: Record<string, unknown>) => WideEventBuilder;
-};
+import { W as WideEventBuilder, c as LoggerConfig, b as Logger, S as SerializedError } from './types-BtTFSWeZ.js';
+export { L as LOG_LEVELS, a as LogLevel, O as OUTCOMES, d as Outcome, T as TerminalFields } from './types-BtTFSWeZ.js';
 
 declare global {
     namespace Express {
@@ -51,4 +23,4 @@ declare const tpagaExpressErrorLogger: (err: unknown, req: Request, _res: Respon
 declare const getLog: (res: Response) => WideEventBuilder;
 declare const withLogger: <TEvent extends EventWithHeaders>(logger: Logger, operationName: string, handler: HandlerWithBuilder<TEvent>) => (event: TEvent, ..._rest: unknown[]) => Promise<unknown>;
 
-export { LOG_LEVELS, type LogLevel, type Logger, type LoggerConfig, OUTCOMES, type Outcome, type SerializedError, type TerminalFields, type WideEventBuilder, createLogger, getLog, serializeError, tpagaExpressErrorLogger, withLogger, withTpagaExpressLogger };
+export { Logger, LoggerConfig, SerializedError, WideEventBuilder, createLogger, getLog, serializeError, tpagaExpressErrorLogger, withLogger, withTpagaExpressLogger };

package/dist/index.js

@@ -1,6 +1,16 @@
 // src/logger.ts
-import { randomUUID } from "crypto";
 import pino from "pino";
+
+// src/utils.ts
+import { randomUUID } from "crypto";
+var resolveCorrelationId = (headers = {}) => {
+  const h = Object.fromEntries(
+    Object.entries(headers).map(([k, v]) => [k.toLowerCase(), Array.isArray(v) ? v[0] : v])
+  );
+  return h["x-correlation-id"] ?? h["x-request-id"] ?? randomUUID();
+};
+
+// src/logger.ts
 var serializeError = (err) => {
   if (!(err instanceof Error)) return { type: "UnknownError", message: String(err) };
   const errorDetails = err.issues;
@@ -37,10 +47,6 @@ var createLogger = (config) => {
     startOperation: (functionName, base = {}) => createWideEventBuilder({ function: functionName, ...base }, log)
   };
 };
-var resolveCorrelationId = (headers = {}) => {
-  const h = Object.fromEntries(Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v]));
-  return h["x-correlation-id"] ?? h["x-request-id"] ?? randomUUID();
-};
 var EXPRESS_LOG_KEY = "tpagaLog";
 var withTpagaExpressLogger = (logger) => (req, res, next) => {
   const start = Date.now();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/logger.ts","../src/constants.ts"],"sourcesContent":["import { randomUUID } from 'crypto';\nimport pino from 'pino';\nimport type { NextFunction, Request, Response } from 'express';\nimport type { Logger, LoggerConfig, SerializedError, TerminalFields, WideEventBuilder } from './types.js';\n\ndeclare global {\n  namespace Express {\n    interface Request {\n      log: WideEventBuilder;\n    }\n    interface Response {\n      log: WideEventBuilder;\n    }\n  }\n}\n\nexport const serializeError = (err: unknown): SerializedError => {\n  if (!(err instanceof Error)) return { type: 'UnknownError', message: String(err) };\n  const errorDetails = (err as { issues?: unknown }).issues;\n  return {\n    type: err.name,\n    message: errorDetails != null ? 'Validation failed' : err.message,\n    code: (err as { code?: string }).code,\n    errorDetails,\n  };\n};\n\nconst createWideEventBuilder = (\n  base: Record<string, unknown>,\n  log: pino.Logger,\n): WideEventBuilder => {\n  const ctx = { ...base };\n  return {\n    with: (fields) => Object.assign(ctx, fields),\n    emit: (level, message, terminal: TerminalFields) => log[level]({ ...ctx, ...terminal }, message),\n  };\n};\n\nexport const createLogger = (config: LoggerConfig): Logger => {\n  const pretty = process.env.LOG_PRETTY === 'true';\n  const log = pino({\n    level: process.env.LOG_LEVEL ?? 'info',\n    base: { service: config.service, environment: config.environment },\n    formatters: {\n      level: (label) => ({ level: label }),\n    },\n    timestamp: pino.stdTimeFunctions.isoTime,\n    redact: {\n      paths: (config.redactKeys as string[]) ?? [],\n      censor: '[REDACTED]',\n    },\n    ...(pretty ? { transport: { target: 'pino-pretty', options: { colorize: true } } } : {}),\n  });\n\n  return {\n    startOperation: (functionName, base = {}) =>\n      createWideEventBuilder({ function: functionName, ...base }, log),\n  };\n};\n\ntype EventWithHeaders = { headers?: Record<string, string | undefined> };\ntype HandlerWithBuilder<TEvent> = (event: TEvent, builder: WideEventBuilder) => Promise<unknown>;\n\nconst resolveCorrelationId = (headers: Record<string, string | undefined> = {}): string => {\n  const h = Object.fromEntries(Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v]));\n  return h['x-correlation-id'] ?? h['x-request-id'] ?? randomUUID();\n};\n\nconst EXPRESS_LOG_KEY = 'tpagaLog';\n\nexport const withTpagaExpressLogger = (logger: Logger) =>\n  (req: Request, res: Response, next: NextFunction): void => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(req.headers as Record<string, string | undefined>);\n    const log = logger.startOperation(req.path, { correlationId, method: req.method });\n\n    req.log = log;\n    res.log = log;\n    res.locals[EXPRESS_LOG_KEY] = log;\n\n    res.on('finish', () => {\n      log.emit('info', 'request completed', {\n        outcome: res.statusCode < 400 ? 'success' : 'error',\n        durationMs: Date.now() - start,\n        statusCode: res.statusCode,\n      });\n    });\n\n    next();\n  };\n\nexport const tpagaExpressErrorLogger = (err: unknown, req: Request, _res: Response, next: NextFunction): void => {\n  req.log.with({ error: serializeError(err) });\n  next(err);\n};\n\nexport const getLog = (res: Response): WideEventBuilder =>\n  res.locals[EXPRESS_LOG_KEY] as WideEventBuilder;\n\nexport const withLogger = <TEvent extends EventWithHeaders>(\n  logger: Logger,\n  operationName: string,\n  handler: HandlerWithBuilder<TEvent>,\n) =>\n  async (event: TEvent, ..._rest: unknown[]): Promise<unknown> => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(event.headers);\n    const builder = logger.startOperation(operationName, { correlationId });\n\n    try {\n      const result = await handler(event, builder);\n      const statusCode =\n        result != null &&\n        typeof result === 'object' &&\n        'statusCode' in result &&\n        typeof (result as { statusCode: unknown }).statusCode === 'number'\n          ? (result as { statusCode: number }).statusCode\n          : undefined;\n      builder.emit('info', `${operationName} completed`, {\n        outcome: 'success',\n        durationMs: Date.now() - start,\n        ...(statusCode !== undefined ? { statusCode } : {}),\n      });\n      return result;\n    } catch (err) {\n      builder.emit('error', `${operationName} failed`, {\n        outcome: 'error',\n        durationMs: Date.now() - start,\n        error: serializeError(err),\n      });\n      throw err;\n    }\n  };\n","export const LOG_LEVELS = ['info', 'warn', 'error', 'debug'] as const;\n\nexport const OUTCOMES = [\n  'success',\n  'error',\n  'validation_failed',\n  'not_found',\n  'conflict',\n  'timeout',\n  'skipped',\n] as const;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/logger.ts","../src/utils.ts","../src/constants.ts"],"sourcesContent":["import pino from 'pino';\nimport type { NextFunction, Request, Response } from 'express';\nimport type { Logger, LoggerConfig, SerializedError, TerminalFields, WideEventBuilder } from './types.js';\nimport { resolveCorrelationId } from './utils.js';\n\ndeclare global {\n  namespace Express {\n    interface Request {\n      log: WideEventBuilder;\n    }\n    interface Response {\n      log: WideEventBuilder;\n    }\n  }\n}\n\nexport const serializeError = (err: unknown): SerializedError => {\n  if (!(err instanceof Error)) return { type: 'UnknownError', message: String(err) };\n  const errorDetails = (err as { issues?: unknown }).issues;\n  return {\n    type: err.name,\n    message: errorDetails != null ? 'Validation failed' : err.message,\n    code: (err as { code?: string }).code,\n    errorDetails,\n  };\n};\n\nconst createWideEventBuilder = (\n  base: Record<string, unknown>,\n  log: pino.Logger,\n): WideEventBuilder => {\n  const ctx = { ...base };\n  return {\n    with: (fields) => Object.assign(ctx, fields),\n    emit: (level, message, terminal: TerminalFields) => log[level]({ ...ctx, ...terminal }, message),\n  };\n};\n\nexport const createLogger = (config: LoggerConfig): Logger => {\n  const pretty = process.env.LOG_PRETTY === 'true';\n  const log = pino({\n    level: process.env.LOG_LEVEL ?? 'info',\n    base: { service: config.service, environment: config.environment },\n    formatters: {\n      level: (label) => ({ level: label }),\n    },\n    timestamp: pino.stdTimeFunctions.isoTime,\n    redact: {\n      paths: (config.redactKeys as string[]) ?? [],\n      censor: '[REDACTED]',\n    },\n    ...(pretty ? { transport: { target: 'pino-pretty', options: { colorize: true } } } : {}),\n  });\n\n  return {\n    startOperation: (functionName, base = {}) =>\n      createWideEventBuilder({ function: functionName, ...base }, log),\n  };\n};\n\ntype EventWithHeaders = { headers?: Record<string, string | undefined> };\ntype HandlerWithBuilder<TEvent> = (event: TEvent, builder: WideEventBuilder) => Promise<unknown>;\n\nconst EXPRESS_LOG_KEY = 'tpagaLog';\n\nexport const withTpagaExpressLogger = (logger: Logger) =>\n  (req: Request, res: Response, next: NextFunction): void => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(req.headers as Record<string, string | undefined>);\n    const log = logger.startOperation(req.path, { correlationId, method: req.method });\n\n    req.log = log;\n    res.log = log;\n    res.locals[EXPRESS_LOG_KEY] = log;\n\n    res.on('finish', () => {\n      log.emit('info', 'request completed', {\n        outcome: res.statusCode < 400 ? 'success' : 'error',\n        durationMs: Date.now() - start,\n        statusCode: res.statusCode,\n      });\n    });\n\n    next();\n  };\n\nexport const tpagaExpressErrorLogger = (err: unknown, req: Request, _res: Response, next: NextFunction): void => {\n  req.log.with({ error: serializeError(err) });\n  next(err);\n};\n\nexport const getLog = (res: Response): WideEventBuilder =>\n  res.locals[EXPRESS_LOG_KEY] as WideEventBuilder;\n\nexport const withLogger = <TEvent extends EventWithHeaders>(\n  logger: Logger,\n  operationName: string,\n  handler: HandlerWithBuilder<TEvent>,\n) =>\n  async (event: TEvent, ..._rest: unknown[]): Promise<unknown> => {\n    const start = Date.now();\n    const correlationId = resolveCorrelationId(event.headers);\n    const builder = logger.startOperation(operationName, { correlationId });\n\n    try {\n      const result = await handler(event, builder);\n      const statusCode =\n        result != null &&\n        typeof result === 'object' &&\n        'statusCode' in result &&\n        typeof (result as { statusCode: unknown }).statusCode === 'number'\n          ? (result as { statusCode: number }).statusCode\n          : undefined;\n      builder.emit('info', `${operationName} completed`, {\n        outcome: 'success',\n        durationMs: Date.now() - start,\n        ...(statusCode !== undefined ? { statusCode } : {}),\n      });\n      return result;\n    } catch (err) {\n      builder.emit('error', `${operationName} failed`, {\n        outcome: 'error',\n        durationMs: Date.now() - start,\n        error: serializeError(err),\n      });\n      throw err;\n    }\n  };\n","import { randomUUID } from 'crypto';\n\nexport const resolveCorrelationId = (\n  headers: Record<string, string | string[] | undefined> = {},\n): string => {\n  const h = Object.fromEntries(\n    Object.entries(headers).map(([k, v]) => [k.toLowerCase(), Array.isArray(v) ? v[0] : v]),\n  );\n  return h['x-correlation-id'] ?? h['x-request-id'] ?? randomUUID();\n};\n","export const LOG_LEVELS = ['info', 'warn', 'error', 'debug'] as const;\n\nexport const OUTCOMES = [\n  'success',\n  'error',\n  'validation_failed',\n  'not_found',\n  'conflict',\n  'timeout',\n  'skipped',\n] as const;\n"],"mappings":"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","names":[]}

package/dist/types-BtTFSWeZ.d.cts

@@ -0,0 +1,31 @@
+declare const LOG_LEVELS: readonly ["info", "warn", "error", "debug"];
+declare const OUTCOMES: readonly ["success", "error", "validation_failed", "not_found", "conflict", "timeout", "skipped"];
+
+type LogLevel = (typeof LOG_LEVELS)[number];
+type Outcome = (typeof OUTCOMES)[number];
+type LoggerConfig = {
+    service: string;
+    environment?: string;
+    redactKeys?: readonly string[];
+};
+type SerializedError = {
+    type: string;
+    message: string;
+    code?: string;
+    errorDetails?: unknown;
+};
+type TerminalFields = {
+    outcome: Outcome | string;
+    durationMs: number;
+    statusCode?: number;
+    error?: SerializedError;
+};
+type WideEventBuilder = {
+    with: (fields: Record<string, unknown>) => void;
+    emit: (level: LogLevel, message: string, terminal: TerminalFields) => void;
+};
+type Logger = {
+    startOperation: (functionName: string, base?: Record<string, unknown>) => WideEventBuilder;
+};
+
+export { LOG_LEVELS as L, OUTCOMES as O, type SerializedError as S, type TerminalFields as T, type WideEventBuilder as W, type LogLevel as a, type Logger as b, type LoggerConfig as c, type Outcome as d };

package/dist/types-BtTFSWeZ.d.ts

@@ -0,0 +1,31 @@
+declare const LOG_LEVELS: readonly ["info", "warn", "error", "debug"];
+declare const OUTCOMES: readonly ["success", "error", "validation_failed", "not_found", "conflict", "timeout", "skipped"];
+
+type LogLevel = (typeof LOG_LEVELS)[number];
+type Outcome = (typeof OUTCOMES)[number];
+type LoggerConfig = {
+    service: string;
+    environment?: string;
+    redactKeys?: readonly string[];
+};
+type SerializedError = {
+    type: string;
+    message: string;
+    code?: string;
+    errorDetails?: unknown;
+};
+type TerminalFields = {
+    outcome: Outcome | string;
+    durationMs: number;
+    statusCode?: number;
+    error?: SerializedError;
+};
+type WideEventBuilder = {
+    with: (fields: Record<string, unknown>) => void;
+    emit: (level: LogLevel, message: string, terminal: TerminalFields) => void;
+};
+type Logger = {
+    startOperation: (functionName: string, base?: Record<string, unknown>) => WideEventBuilder;
+};
+
+export { LOG_LEVELS as L, OUTCOMES as O, type SerializedError as S, type TerminalFields as T, type WideEventBuilder as W, type LogLevel as a, type Logger as b, type LoggerConfig as c, type Outcome as d };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tpaga-logger",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "Structured logging SDK for Tpaga microservices (wide events → CloudWatch)",
   "type": "module",
   "publishConfig": {
@@ -14,6 +14,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./fastify": {
+      "types": "./dist/fastify.d.ts",
+      "import": "./dist/fastify.js",
+      "require": "./dist/fastify.cjs"
     }
   },
   "files": [
@@ -22,33 +27,49 @@
   "engmake sines": {
     "node": ">=20"
   },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src tests",
+    "typecheck": "tsc --noEmit"
+  },
   "dependencies": {
+    "fastify-plugin": "^6.0.0",
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3"
   },
   "peerDependencies": {
-    "express": ">=4"
+    "@nestjs/common": ">=10",
+    "express": ">=4",
+    "fastify": ">=4",
+    "rxjs": ">=7"
   },
   "peerDependenciesMeta": {
     "express": {
       "optional": true
+    },
+    "fastify": {
+      "optional": true
+    },
+    "@nestjs/common": {
+      "optional": true
+    },
+    "rxjs": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@eslint/js": "^9.28.0",
+    "@nestjs/common": "^11.1.27",
     "@types/express": "^5.0.6",
     "@types/node": "^22.15.0",
     "eslint": "^9.28.0",
+    "fastify": "^5.9.0",
+    "rxjs": "^7.8.2",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.33.0",
     "vitest": "^3.2.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src tests",
-    "typecheck": "tsc --noEmit"
   }
-}
+}