@myvitalrx/unilogger

Centralized Winston-based logger for Node.js and AWS Lambda projects.

Install

npm install @myvitalrx/unilogger

Usage

import { logger, logUserEvent, createChildLogger } from '@myvitalrx/unilogger';
logger.info('App started');

Pass requestId, traceId

logger.info('Handling request', { requestId, traceId });

Log user events

logUserEvent({
  userId: '123',
  actor: 'PATIENT',
  eventType: 'VIEW_MEDICAL_RECORD',
  resourceType: 'MEDICAL_RECORD',
  action: 'READ'
});

Create child logger

const moduleLogger = createChildLogger({ module: 'myModule' });
moduleLogger.info('Module started');

Override transports

import { createLogger, ConsoleTransport } from '@myvitalrx/unilogger';
const customLogger = createLogger({
  transports: [new ConsoleTransport()]
});

Use inside AWS Lambda

export const handler = async (event) => {
  logger.info('Lambda invoked', { requestId: event.requestContext.requestId });
  // ...
};

Security notes

• Never log raw PII; always hash with hashPII.
• Rotate LOG_SECRET regularly.

Environment Variables

• LOG_LEVEL (default: info)
• SERVICE_NAME
• LOG_SECRET
• LOG_ROTATE_DIR
• LOG_ROTATE_MAX_FILES
• LOG_TO_FILE (boolean)

Build & Test

npm run build
npm run test

Publish

npm publish --access public