@pantomartech/logger

Shared Pino structured JSON logger for Node.js services. See the Event Pipeline logging-prd.md for the full contract (fields, redaction, trace propagation).

Install

Install from npmjs:

npm install @pantomartech/logger

Package: https://www.npmjs.com/package/@pantomartech/logger

Usage

import { createLogger, logStorage, createContext, getContext } from '@pantomartech/logger';

export const logger = createLogger({ service: process.env.SERVICE_NAME ?? 'my-service' });

// Per-request or per-job async scope
await logStorage.run(createContext(), async () => {
  logger.info({ jobId: '123' }, 'Job started');
});

Express apps: app.use(httpLogger) from @pantomartech/logger.

Environment

| Variable | Purpose | |----------------|----------------------------------| | SERVICE_NAME | service field in every line | | NODE_ENV | production → NDJSON to stdout; else pino-pretty (bundled dependency) | | LOG_LEVEL | Pino level (default info) | | APP_VERSION | version field |

Build

npm install
npm run build

Outputs dist/ (CommonJS + .d.ts).