serverless-event-logger 1.0.0

package/README.md

@@ -0,0 +1,262 @@
+# serverless-event-logger
+
+🚀 Lightweight, zero-dependency structured JSON logger for AWS Lambda. Optimized for observability with automatic context extraction from serverless events.
+
+[![npm version](https://badge.fury.io/js/serverless-event-logger.svg)](https://www.npmjs.com/package/serverless-event-logger)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **Zero dependencies** - Minimal bundle size (< 5KB minified)
+- **Structured JSON output** - Perfect for CloudWatch Insights queries
+- **Automatic context extraction** - Captures requestId, userId, segment from events
+- **Log level filtering** - debug, info, warn, error
+- **Sensitive data redaction** - Automatically redact passwords, tokens, etc.
+- **Timer utility** - Measure operation duration
+- **Child loggers** - Add module-specific context
+- **TypeScript first** - Full type definitions included
+
+## Installation
+
+```bash
+npm install serverless-event-logger
+```
+
+## Quick Start
+
+```typescript
+import { createLogger } from 'serverless-event-logger';
+
+// Create a logger instance
+const logger = createLogger({
+  service: 'my-lambda',
+});
+
+// Basic logging
+logger.info('User created', { userId: '123' });
+// Output: {"timestamp":"2024-01-15T10:30:00.000Z","level":"info","message":"User created","service":"my-lambda","userId":"123"}
+
+logger.error('Database connection failed', { error: err.message });
+```
+
+## Usage with Lambda Events
+
+```typescript
+import { createLogger } from 'serverless-event-logger';
+import { NormalizedEvent } from 'serverless-event-orchestrator';
+
+const logger = createLogger({
+  service: 'ml-properties-lambda',
+});
+
+async function handler(event: NormalizedEvent) {
+  // Create logger with request context
+  const log = logger.withContext(event);
+  
+  log.info('Handler started');
+  // Output includes: requestId, userId, segment, path, method
+  
+  try {
+    const result = await processRequest(event);
+    log.info('Request processed', { resultId: result.id });
+    return result;
+  } catch (error) {
+    log.error('Request failed', { error: error.message, stack: error.stack });
+    throw error;
+  }
+}
+```
+
+## API Reference
+
+### `createLogger(config)`
+
+Creates a new logger instance.
+
+```typescript
+interface LoggerConfig {
+  service: string;                    // REQUIRED: Name of your lambda/service
+  defaultLevel?: LogLevel;            // Default: 'info'
+  silent?: boolean;                   // Default: false (set true for tests)
+  redactPaths?: string[];             // Fields to redact (e.g., ['password', 'token'])
+  timestampFormat?: 'iso' | 'epoch';  // Default: 'iso'
+  pretty?: boolean;                   // Default: false (formatted output for local dev)
+}
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+```
+
+### Logging Methods
+
+```typescript
+logger.debug(message: string, data?: object): void
+logger.info(message: string, data?: object): void
+logger.warn(message: string, data?: object): void
+logger.error(message: string, data?: object): void
+```
+
+### `logger.withContext(event)`
+
+Creates a new logger with context extracted from a `NormalizedEvent`:
+
+```typescript
+const log = logger.withContext(event);
+// Extracts: requestId, userId, segment, path, method, userAgent
+```
+
+### `logger.child(fields)`
+
+Creates a child logger with additional fixed fields:
+
+```typescript
+const dbLogger = logger.child({ module: 'dynamodb' });
+dbLogger.info('Query executed', { table: 'Users' });
+// Output includes module: 'dynamodb'
+```
+
+### `logger.startTimer(label)`
+
+Measures operation duration:
+
+```typescript
+const timer = log.startTimer('database-query');
+await db.query(...);
+timer.done({ recordsFound: 150 });
+// Output: {"message":"database-query completed","duration":234,"recordsFound":150,...}
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `LOG_LEVEL` | Minimum log level | `info` |
+| `LOG_SILENT` | Disable all logs | `false` |
+| `LOG_PRETTY` | Formatted output | `false` |
+
+### Sensitive Data Redaction
+
+```typescript
+const logger = createLogger({
+  service: 'auth-lambda',
+  redactPaths: ['password', 'token', 'authorization', 'apiKey'],
+});
+
+logger.info('Login attempt', { 
+  username: 'john',
+  password: 'secret123' 
+});
+// Output: {..., "username": "john", "password": "[REDACTED]"}
+```
+
+## Log Output Structure
+
+### Base Fields (always present)
+
+```json
+{
+  "timestamp": "2024-01-15T10:30:00.000Z",
+  "level": "info",
+  "message": "Your log message",
+  "service": "your-service-name"
+}
+```
+
+### Context Fields (with `withContext`)
+
+```json
+{
+  "requestId": "abc-123-def-456",
+  "userId": "user_abc123",
+  "segment": "private",
+  "path": "/api/users",
+  "method": "POST",
+  "userAgent": "Mozilla/5.0..."
+}
+```
+
+## CloudWatch Insights Queries
+
+### Find errors by endpoint
+
+```sql
+fields @timestamp, message, path, method, error, userId
+| filter level = "error"
+| filter service = "my-lambda"
+| sort @timestamp desc
+| limit 100
+```
+
+### Latency analysis
+
+```sql
+fields @timestamp, path, method, duration
+| filter message like /completed/
+| stats avg(duration) as avg_ms, max(duration) as max_ms by path, method
+| sort avg_ms desc
+```
+
+### User activity trace
+
+```sql
+fields @timestamp, level, message, path
+| filter userId = "user_abc123"
+| sort @timestamp desc
+| limit 50
+```
+
+## TypeScript Support
+
+Full TypeScript definitions are included:
+
+```typescript
+import { 
+  createLogger, 
+  Logger, 
+  LoggerConfig, 
+  LogLevel,
+  Timer,
+  NormalizedEventLike 
+} from 'serverless-event-logger';
+```
+
+## Best Practices
+
+1. **Create one logger per service** - Initialize at module level
+2. **Use `withContext` in handlers** - Captures request-specific info
+3. **Use `child` for modules** - Adds component context
+4. **Redact sensitive data** - Configure `redactPaths`
+5. **Use timers for slow operations** - Helps identify bottlenecks
+
+```typescript
+// src/logging.ts
+export const logger = createLogger({
+  service: process.env.LAMBDA_NAME || 'unknown-lambda',
+  redactPaths: ['password', 'token', 'authorization'],
+});
+
+// src/handlers/user.ts
+import { logger } from '../logging';
+
+export async function createUser(event: NormalizedEvent) {
+  const log = logger.withContext(event);
+  log.info('Creating user', { email: event.payload.body.email });
+  // ...
+}
+
+// src/repositories/user-repository.ts
+import { logger } from '../logging';
+
+const log = logger.child({ module: 'UserRepository' });
+
+export async function save(user: User) {
+  const timer = log.startTimer('dynamodb-put');
+  await db.put(user);
+  timer.done({ userId: user.id });
+}
+```
+
+## License
+
+MIT © MLHolding

package/dist/constants.d.ts

@@ -0,0 +1,23 @@
+import type { LogLevel, ResolvedLoggerConfig } from './types';
+/**
+ * Log level priority mapping.
+ * Lower number = more verbose (will log more)
+ */
+export declare const LOG_LEVELS: Record<LogLevel, number>;
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Omit<ResolvedLoggerConfig, 'service'>;
+/**
+ * Environment variable names
+ */
+export declare const ENV_VARS: {
+    readonly LOG_LEVEL: "LOG_LEVEL";
+    readonly LOG_SILENT: "LOG_SILENT";
+    readonly LOG_PRETTY: "LOG_PRETTY";
+};
+/**
+ * Redaction placeholder
+ */
+export declare const REDACTED_VALUE = "[REDACTED]";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAMtC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAMvD,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;CAIX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,eAAe,CAAC"}

package/dist/constants.js

@@ -0,0 +1,33 @@
+/**
+ * Log level priority mapping.
+ * Lower number = more verbose (will log more)
+ */
+export const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    defaultLevel: 'info',
+    silent: false,
+    redactPaths: [],
+    timestampFormat: 'iso',
+    pretty: false,
+};
+/**
+ * Environment variable names
+ */
+export const ENV_VARS = {
+    LOG_LEVEL: 'LOG_LEVEL',
+    LOG_SILENT: 'LOG_SILENT',
+    LOG_PRETTY: 'LOG_PRETTY',
+};
+/**
+ * Redaction placeholder
+ */
+export const REDACTED_VALUE = '[REDACTED]';

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACU,QAAA,UAAU,GAA6B;IAClD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACD,CAAC;AAEX;;GAEG;AACU,QAAA,cAAc,GAA0C;IACnE,YAAY,EAAE,MAAM;IACpB,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,EAAE;IACf,eAAe,EAAE,KAAK;IACtB,MAAM,EAAE,KAAK;CACL,CAAC;AAEX;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;CAChB,CAAC;AAEX;;GAEG;AACU,QAAA,cAAc,GAAG,YAAY,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * serverless-event-logger
+ *
+ * Lightweight, zero-dependency structured JSON logger for AWS Lambda.
+ * Optimized for observability with automatic context extraction from serverless events.
+ *
+ * @packageDocumentation
+ */
+export { Logger, createLogger } from './logger';
+export type { LogLevel, LoggerConfig, Timer, ILogger, LogEntry, ContextFields, AdditionalFields, LogOutput, NormalizedEventLike, TimestampFormat, } from './types';
+export { LOG_LEVELS, REDACTED_VALUE } from './constants';
+export { extractContext, generateRequestId } from './utils/extract-context';
+export { serializeError } from './utils/format';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEhD,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,OAAO,EACP,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,mBAAmB,EACnB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * serverless-event-logger
+ *
+ * Lightweight, zero-dependency structured JSON logger for AWS Lambda.
+ * Optimized for observability with automatic context extraction from serverless events.
+ *
+ * @packageDocumentation
+ */
+export { Logger, createLogger } from './logger';
+export { LOG_LEVELS, REDACTED_VALUE } from './constants';
+export { extractContext, generateRequestId } from './utils/extract-context';
+export { serializeError } from './utils/format';

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,mCAAgD;AAAvC,gGAAA,MAAM,OAAA;AAAE,sGAAA,YAAY,OAAA;AAe7B,yCAAyD;AAAhD,uGAAA,UAAU,OAAA;AAAE,2GAAA,cAAc,OAAA;AAEnC,2DAA4E;AAAnE,iHAAA,cAAc,OAAA;AAAE,oHAAA,iBAAiB,OAAA;AAC1C,yCAAgD;AAAvC,wGAAA,cAAc,OAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,67 @@
+import type { LoggerConfig, Timer, ILogger, NormalizedEventLike } from './types';
+/**
+ * Logger class for structured JSON logging.
+ * Optimized for AWS Lambda and CloudWatch Insights.
+ */
+export declare class Logger implements ILogger {
+    private readonly config;
+    private readonly contextData;
+    constructor(config: LoggerConfig, context?: Record<string, unknown>);
+    /**
+     * Creates a new Logger instance with context extracted from a NormalizedEvent.
+     * The new logger includes requestId, userId, segment, path, method from the event.
+     */
+    withContext(event: NormalizedEventLike): Logger;
+    /**
+     * Creates a child logger with additional fixed fields.
+     * Useful for adding module-specific context.
+     */
+    child(fields: Record<string, unknown>): Logger;
+    /**
+     * Log a debug message. Only outputs if LOG_LEVEL is 'debug'.
+     */
+    debug(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log an info message.
+     */
+    info(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log a warning message.
+     */
+    warn(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log an error message.
+     */
+    error(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Starts a timer for measuring operation duration.
+     * Call timer.done() when the operation completes.
+     *
+     * @param label - Description of the operation being timed
+     * @returns Timer object with done() method
+     */
+    startTimer(label: string): Timer;
+    /**
+     * Internal method to output a log entry
+     */
+    private log;
+    /**
+     * Redacts sensitive fields from data
+     */
+    private redact;
+}
+/**
+ * Factory function to create a new Logger instance.
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger({
+ *   service: 'my-lambda',
+ *   defaultLevel: 'info',
+ * });
+ *
+ * logger.info('Hello world', { userId: '123' });
+ * ```
+ */
+export declare function createLogger(config: LoggerConfig): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAIZ,KAAK,EACL,OAAO,EACP,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAsBjB;;;GAGG;AACH,qBAAa,MAAO,YAAW,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;gBAE1C,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAKvE;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM;IAQ/C;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAO9C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK;IAUhC;;OAEG;IACH,OAAO,CAAC,GAAG;IA4CX;;OAEG;IACH,OAAO,CAAC,MAAM;CAMf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEzD"}

package/dist/logger.js

@@ -0,0 +1,148 @@
+import { LOG_LEVELS, DEFAULT_CONFIG, ENV_VARS } from './constants';
+import { redactFields, getTimestamp, formatLogEntry, extractContext } from './utils';
+/**
+ * Resolves configuration by merging provided config with defaults and environment variables
+ */
+function resolveConfig(config) {
+    const envLevel = process.env[ENV_VARS.LOG_LEVEL];
+    const envSilent = process.env[ENV_VARS.LOG_SILENT] === 'true';
+    const envPretty = process.env[ENV_VARS.LOG_PRETTY] === 'true';
+    return {
+        service: config.service,
+        defaultLevel: config.defaultLevel ?? envLevel ?? DEFAULT_CONFIG.defaultLevel,
+        silent: config.silent ?? envSilent ?? DEFAULT_CONFIG.silent,
+        redactPaths: config.redactPaths ?? DEFAULT_CONFIG.redactPaths,
+        timestampFormat: config.timestampFormat ?? DEFAULT_CONFIG.timestampFormat,
+        pretty: config.pretty ?? envPretty ?? DEFAULT_CONFIG.pretty,
+    };
+}
+/**
+ * Logger class for structured JSON logging.
+ * Optimized for AWS Lambda and CloudWatch Insights.
+ */
+export class Logger {
+    constructor(config, context = {}) {
+        this.config = resolveConfig(config);
+        this.contextData = context;
+    }
+    /**
+     * Creates a new Logger instance with context extracted from a NormalizedEvent.
+     * The new logger includes requestId, userId, segment, path, method from the event.
+     */
+    withContext(event) {
+        const eventContext = extractContext(event);
+        return new Logger(this.config, { ...this.contextData, ...eventContext });
+    }
+    /**
+     * Creates a child logger with additional fixed fields.
+     * Useful for adding module-specific context.
+     */
+    child(fields) {
+        return new Logger(this.config, { ...this.contextData, ...fields });
+    }
+    /**
+     * Log a debug message. Only outputs if LOG_LEVEL is 'debug'.
+     */
+    debug(message, data) {
+        this.log('debug', message, data);
+    }
+    /**
+     * Log an info message.
+     */
+    info(message, data) {
+        this.log('info', message, data);
+    }
+    /**
+     * Log a warning message.
+     */
+    warn(message, data) {
+        this.log('warn', message, data);
+    }
+    /**
+     * Log an error message.
+     */
+    error(message, data) {
+        this.log('error', message, data);
+    }
+    /**
+     * Starts a timer for measuring operation duration.
+     * Call timer.done() when the operation completes.
+     *
+     * @param label - Description of the operation being timed
+     * @returns Timer object with done() method
+     */
+    startTimer(label) {
+        const start = Date.now();
+        return {
+            done: (data) => {
+                const duration = Date.now() - start;
+                this.info(`${label} completed`, { duration, ...data });
+            },
+        };
+    }
+    /**
+     * Internal method to output a log entry
+     */
+    log(level, message, data) {
+        // Check if logging is disabled
+        if (this.config.silent) {
+            return;
+        }
+        // Check log level threshold
+        const currentLevelPriority = LOG_LEVELS[level];
+        const configuredLevelPriority = LOG_LEVELS[this.config.defaultLevel];
+        if (currentLevelPriority === undefined || configuredLevelPriority === undefined) {
+            return;
+        }
+        if (currentLevelPriority < configuredLevelPriority) {
+            return;
+        }
+        // Build log entry
+        const entry = {
+            timestamp: getTimestamp(this.config.timestampFormat),
+            level,
+            message,
+            service: this.config.service,
+            ...this.contextData,
+            ...this.redact(data),
+        };
+        // Format output
+        const output = formatLogEntry(entry, this.config.pretty);
+        // Output to appropriate console method for CloudWatch categorization
+        switch (level) {
+            case 'error':
+                console.error(output);
+                break;
+            case 'warn':
+                console.warn(output);
+                break;
+            default:
+                console.log(output);
+        }
+    }
+    /**
+     * Redacts sensitive fields from data
+     */
+    redact(data) {
+        if (!data || this.config.redactPaths.length === 0) {
+            return data ?? {};
+        }
+        return redactFields(data, this.config.redactPaths);
+    }
+}
+/**
+ * Factory function to create a new Logger instance.
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger({
+ *   service: 'my-lambda',
+ *   defaultLevel: 'info',
+ * });
+ *
+ * logger.info('Hello world', { userId: '123' });
+ * ```
+ */
+export function createLogger(config) {
+    return new Logger(config);
+}

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Log levels supported by the logger
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Timestamp format options
+ */
+export type TimestampFormat = 'iso' | 'epoch';
+/**
+ * Configuration options for creating a logger instance
+ */
+export interface LoggerConfig {
+    /** REQUIRED: Name of the lambda/service */
+    service: string;
+    /** Minimum log level to output. Default: 'info' */
+    defaultLevel?: LogLevel;
+    /** If true, disables all log output (useful for tests). Default: false */
+    silent?: boolean;
+    /** Array of field names to redact from logs (e.g., ['password', 'token']) */
+    redactPaths?: string[];
+    /** Timestamp format. Default: 'iso' */
+    timestampFormat?: TimestampFormat;
+    /** If true, outputs formatted JSON (useful for local development). Default: false */
+    pretty?: boolean;
+}
+/**
+ * Internal resolved configuration (all fields required)
+ */
+export interface ResolvedLoggerConfig {
+    service: string;
+    defaultLevel: LogLevel;
+    silent: boolean;
+    redactPaths: string[];
+    timestampFormat: TimestampFormat;
+    pretty: boolean;
+}
+/**
+ * Base fields always present in log output
+ */
+export interface LogEntry {
+    timestamp: string | number;
+    level: LogLevel;
+    message: string;
+    service: string;
+}
+/**
+ * Context fields extracted from NormalizedEvent
+ */
+export interface ContextFields {
+    requestId?: string;
+    userId?: string;
+    segment?: string;
+    path?: string;
+    method?: string;
+    userAgent?: string;
+}
+/**
+ * Additional fields that can be added to log entries
+ */
+export interface AdditionalFields {
+    [key: string]: unknown;
+    error?: string;
+    stack?: string;
+    duration?: number;
+    module?: string;
+}
+/**
+ * Complete log output structure
+ */
+export type LogOutput = LogEntry & ContextFields & AdditionalFields;
+/**
+ * Timer interface returned by startTimer()
+ */
+export interface Timer {
+    /** Call when the operation is complete */
+    done: (data?: Record<string, unknown>) => void;
+}
+/**
+ * Identity information from NormalizedEvent
+ */
+export interface EventIdentity {
+    userId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Context from NormalizedEvent
+ */
+export interface EventContext {
+    requestId?: string;
+    identity?: EventIdentity;
+    segment?: string;
+    [key: string]: unknown;
+}
+/**
+ * Payload from NormalizedEvent
+ */
+export interface EventPayload {
+    httpMethod?: string;
+    path?: string;
+    headers?: Record<string, string | undefined>;
+    [key: string]: unknown;
+}
+/**
+ * Minimal NormalizedEvent interface for context extraction.
+ * Compatible with serverless-event-orchestrator's NormalizedEvent.
+ */
+export interface NormalizedEventLike {
+    context?: EventContext;
+    payload?: EventPayload;
+    [key: string]: unknown;
+}
+/**
+ * Logger interface defining the public API
+ */
+export interface ILogger {
+    /** Log a debug message */
+    debug(message: string, data?: Record<string, unknown>): void;
+    /** Log an info message */
+    info(message: string, data?: Record<string, unknown>): void;
+    /** Log a warning message */
+    warn(message: string, data?: Record<string, unknown>): void;
+    /** Log an error message */
+    error(message: string, data?: Record<string, unknown>): void;
+    /** Create a new logger with context extracted from a NormalizedEvent */
+    withContext(event: NormalizedEventLike): ILogger;
+    /** Create a child logger with additional fixed fields */
+    child(fields: Record<string, unknown>): ILogger;
+    /** Start a timer for measuring operation duration */
+    startTimer(label: string): Timer;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/types.js.map

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

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

@@ -0,0 +1,14 @@
+import type { ContextFields, NormalizedEventLike } from '../types';
+/**
+ * Generates a unique request ID
+ */
+export declare function generateRequestId(): string;
+/**
+ * Extracts logging context from a NormalizedEvent.
+ * Compatible with serverless-event-orchestrator's NormalizedEvent structure.
+ *
+ * @param event - The NormalizedEvent or similar event object
+ * @returns Context fields for logging
+ */
+export declare function extractContext(event: NormalizedEventLike): ContextFields;
+//# sourceMappingURL=extract-context.d.ts.map

package/dist/utils/extract-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-context.d.ts","sourceRoot":"","sources":["../../src/utils/extract-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEnE;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,aAAa,CAsCxE"}

package/dist/utils/extract-context.js

@@ -0,0 +1,44 @@
+/**
+ * Generates a unique request ID
+ */
+export function generateRequestId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 11);
+    return `req_${timestamp}_${random}`;
+}
+/**
+ * Extracts logging context from a NormalizedEvent.
+ * Compatible with serverless-event-orchestrator's NormalizedEvent structure.
+ *
+ * @param event - The NormalizedEvent or similar event object
+ * @returns Context fields for logging
+ */
+export function extractContext(event) {
+    const context = {};
+    // Extract requestId
+    context.requestId = event.context?.requestId || generateRequestId();
+    // Extract userId from identity
+    if (event.context?.identity?.userId) {
+        context.userId = event.context.identity.userId;
+    }
+    // Extract segment
+    if (event.context?.segment) {
+        context.segment = event.context.segment;
+    }
+    // Extract HTTP method
+    if (event.payload?.httpMethod) {
+        context.method = event.payload.httpMethod;
+    }
+    // Extract path
+    if (event.payload?.path) {
+        context.path = event.payload.path;
+    }
+    // Extract User-Agent (optional)
+    const userAgent = event.payload?.headers?.['user-agent'] ||
+        event.payload?.headers?.['User-Agent'];
+    if (userAgent) {
+        context.userAgent = userAgent;
+    }
+    // Remove undefined values
+    return Object.fromEntries(Object.entries(context).filter(([, value]) => value !== undefined));
+}

package/dist/utils/extract-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-context.js","sourceRoot":"","sources":["../../src/utils/extract-context.ts"],"names":[],"mappings":";;AAKA,8CAIC;AASD,wCAsCC;AAtDD;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,KAA0B;IACvD,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,oBAAoB;IACpB,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,CAAC;IAEpE,+BAA+B;IAC/B,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACpC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACjD,CAAC;IAED,kBAAkB;IAClB,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;IAC1C,CAAC;IAED,sBAAsB;IACtB,IAAI,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;IAC5C,CAAC;IAED,eAAe;IACf,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,gCAAgC;IAChC,MAAM,SAAS,GACb,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC;QACtC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAChC,CAAC;IAED,0BAA0B;IAC1B,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAClD,CAAC;AACrB,CAAC"}

package/dist/utils/format.d.ts

@@ -0,0 +1,18 @@
+import type { LogOutput, TimestampFormat } from '../types';
+/**
+ * Get current timestamp in the specified format
+ */
+export declare function getTimestamp(format: TimestampFormat): string | number;
+/**
+ * Format a log entry as JSON string
+ *
+ * @param entry - The log entry to format
+ * @param pretty - If true, formats with indentation for readability
+ * @returns JSON string representation of the log entry
+ */
+export declare function formatLogEntry(entry: LogOutput, pretty: boolean): string;
+/**
+ * Safely serialize error objects for logging
+ */
+export declare function serializeError(error: unknown): Record<string, unknown>;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3D;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,CAGrE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAKxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBtE"}

package/dist/utils/format.js

@@ -0,0 +1,39 @@
+/**
+ * Get current timestamp in the specified format
+ */
+export function getTimestamp(format) {
+    const now = new Date();
+    return format === 'epoch' ? now.getTime() : now.toISOString();
+}
+/**
+ * Format a log entry as JSON string
+ *
+ * @param entry - The log entry to format
+ * @param pretty - If true, formats with indentation for readability
+ * @returns JSON string representation of the log entry
+ */
+export function formatLogEntry(entry, pretty) {
+    if (pretty) {
+        return JSON.stringify(entry, null, 2);
+    }
+    return JSON.stringify(entry);
+}
+/**
+ * Safely serialize error objects for logging
+ */
+export function serializeError(error) {
+    if (error instanceof Error) {
+        return {
+            error: error.message,
+            stack: error.stack,
+            name: error.name,
+        };
+    }
+    if (typeof error === 'string') {
+        return { error };
+    }
+    if (typeof error === 'object' && error !== null) {
+        return error;
+    }
+    return { error: String(error) };
+}

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":";;AAKA,oCAGC;AASD,wCAKC;AAKD,wCAkBC;AA3CD;;GAEG;AACH,SAAgB,YAAY,CAAC,MAAuB;IAClD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,KAAgB,EAAE,MAAe;IAC9D,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAgC,CAAC;IAC1C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { redactFields } from './redact';
+export { getTimestamp, formatLogEntry, serializeError } from './format';
+export { extractContext, generateRequestId } from './extract-context';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export { redactFields } from './redact';
+export { getTimestamp, formatLogEntry, serializeError } from './format';
+export { extractContext, generateRequestId } from './extract-context';

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,mCAAwE;AAA/D,sGAAA,YAAY,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,wGAAA,cAAc,OAAA;AACrD,qDAAsE;AAA7D,iHAAA,cAAc,OAAA;AAAE,oHAAA,iBAAiB,OAAA"}

package/dist/utils/redact.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Recursively redacts sensitive fields from an object.
+ * Creates a new object without mutating the original.
+ *
+ * @param data - The object to redact
+ * @param paths - Array of field names to redact (case-insensitive matching)
+ * @returns A new object with sensitive fields replaced by '[REDACTED]'
+ */
+export declare function redactFields(data: Record<string, unknown>, paths: string[]): Record<string, unknown>;
+//# sourceMappingURL=redact.d.ts.map

package/dist/utils/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}

package/dist/utils/redact.js

@@ -0,0 +1,40 @@
+import { REDACTED_VALUE } from '../constants';
+/**
+ * Recursively redacts sensitive fields from an object.
+ * Creates a new object without mutating the original.
+ *
+ * @param data - The object to redact
+ * @param paths - Array of field names to redact (case-insensitive matching)
+ * @returns A new object with sensitive fields replaced by '[REDACTED]'
+ */
+export function redactFields(data, paths) {
+    if (!data || typeof data !== 'object' || paths.length === 0) {
+        return data;
+    }
+    const lowerPaths = paths.map((p) => p.toLowerCase());
+    return redactRecursive(data, lowerPaths);
+}
+function redactRecursive(obj, lowerPaths) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => redactRecursive(item, lowerPaths));
+    }
+    if (typeof obj !== 'object') {
+        return obj;
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (lowerPaths.includes(key.toLowerCase())) {
+            result[key] = REDACTED_VALUE;
+        }
+        else if (value !== null && typeof value === 'object') {
+            result[key] = redactRecursive(value, lowerPaths);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}

package/dist/utils/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":";;AAUA,oCAWC;AArBD,4CAA8C;AAE9C;;;;;;;GAOG;AACH,SAAgB,YAAY,CAC1B,IAA6B,EAC7B,KAAe;IAEf,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAErD,OAAO,eAAe,CAAC,IAAI,EAAE,UAAU,CAA4B,CAAC;AACtE,CAAC;AAED,SAAS,eAAe,CACtB,GAAY,EACZ,UAAoB;IAEpB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;QAC1E,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,0BAAc,CAAC;QAC/B,CAAC;aAAM,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "serverless-event-logger",
+  "version": "1.0.0",
+  "description": "🚀 Lightweight, zero-dependency structured JSON logger for AWS Lambda. Optimized for observability with automatic context extraction from serverless events.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && npm run build:esm",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "npm run build && npm test",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "logging",
+    "logger",
+    "lambda",
+    "aws",
+    "cloudwatch",
+    "json",
+    "structured-logging",
+    "serverless",
+    "observability"
+  ],
+  "author": "MLHolding",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mlholding/serverless-event-logger.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mlholding/serverless-event-logger/issues"
+  },
+  "homepage": "https://github.com/mlholding/serverless-event-logger#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "serverless-event-orchestrator": "^1.2.0"
+  },
+  "peerDependenciesMeta": {
+    "serverless-event-orchestrator": {
+      "optional": true
+    }
+  }
+}