@geekmidas/logger 0.0.1 → 0.1.0

package/README.md

@@ -4,13 +4,12 @@ A simple and flexible structured logging library for Node.js and browsers with c
 
 ## Features
 
-- ✅ **Standard Interface**: Common logger interface with multiple log levels (debug, info, warn, error, fatal, trace)
-- ✅ **Structured Logging**: Support for both structured (object + message) and simple (message only) logging
-- ✅ **Child Loggers**: Create child loggers with inherited context
-- ✅ **Automatic Timestamps**: Automatic timestamp injection on all log entries
-- ✅ **Console-Based**: Built-in ConsoleLogger implementation using standard console methods
-- ✅ **TypeScript**: Full TypeScript support with type-safe logging
-- ✅ **Zero Dependencies**: No external dependencies
+- **Standard Interface**: Common logger interface with multiple log levels (debug, info, warn, error, fatal, trace)
+- **Structured Logging**: Support for both structured (object + message) and simple (message only) logging
+- **Child Loggers**: Create child loggers with inherited context
+- **Multiple Implementations**: ConsoleLogger for simple use, PinoLogger for production
+- **Sensitive Data Redaction**: Built-in redaction for passwords, tokens, API keys, and more
+- **TypeScript**: Full TypeScript support with type-safe logging
 
 ## Installation
 
@@ -38,6 +37,114 @@ logger.info('Application started');
 logger.error({ error, operation: 'fetchUser' }, 'Failed to fetch user');
 ```
 
+## Pino Logger
+
+For production use, the package provides a Pino-based logger with high performance and built-in redaction support.
+
+```typescript
+import { createLogger } from '@geekmidas/logger/pino';
+
+const logger = createLogger({
+  level: 'info',
+  pretty: true,  // Pretty printing in development
+  redact: true,  // Enable sensitive data redaction
+});
+
+logger.info({ userId: 123 }, 'User logged in');
+```
+
+## Sensitive Data Redaction
+
+The Pino logger includes built-in redaction to automatically mask sensitive data like passwords, tokens, and API keys.
+
+### Enable with Defaults
+
+```typescript
+import { createLogger } from '@geekmidas/logger/pino';
+
+const logger = createLogger({ redact: true });
+
+// Sensitive data is automatically masked
+logger.info({ password: 'secret123', user: 'john' }, 'Login attempt');
+// Output: { password: '[Redacted]', user: 'john' } Login attempt
+
+logger.info({ headers: { authorization: 'Bearer xyz' } }, 'Request');
+// Output: { headers: { authorization: '[Redacted]' } } Request
+```
+
+### Default Redacted Fields
+
+When `redact: true`, the following fields are automatically masked:
+
+- **Authentication**: `password`, `pass`, `passwd`, `secret`, `token`, `accessToken`, `refreshToken`, `apiKey`, `api_key`, `authorization`, `credentials`
+- **Headers**: `headers.authorization`, `headers.cookie`, `headers["x-api-key"]`
+- **Personal Data**: `ssn`, `creditCard`, `cardNumber`, `cvv`, `pin`
+- **Secrets**: `connectionString`, `databaseUrl`
+- **Wildcards**: `*.password`, `*.secret`, `*.token` (catches nested fields)
+
+### Add Custom Paths (Merged with Defaults)
+
+```typescript
+const logger = createLogger({
+  redact: ['user.ssn', 'payment.cardNumber'],
+});
+
+// Both custom paths AND defaults are redacted
+logger.info({ password: 'secret', user: { ssn: '123-45-6789' } }, 'Data');
+// Output: { password: '[Redacted]', user: { ssn: '[Redacted]' } } Data
+```
+
+### Override Defaults
+
+Use `resolution: 'override'` to disable default paths and use only your custom paths:
+
+```typescript
+const logger = createLogger({
+  redact: {
+    paths: ['myCustomSecret'],
+    resolution: 'override',
+  },
+});
+
+// Only 'myCustomSecret' is redacted, defaults are ignored
+logger.info({ password: 'visible', myCustomSecret: 'hidden' }, 'Data');
+// Output: { password: 'visible', myCustomSecret: '[Redacted]' } Data
+```
+
+### Custom Censor and Remove
+
+```typescript
+// Custom censor string
+const logger = createLogger({
+  redact: {
+    paths: ['secret'],
+    censor: '***HIDDEN***',
+  },
+});
+
+// Remove fields entirely instead of masking
+const logger2 = createLogger({
+  redact: {
+    paths: ['temporaryData'],
+    remove: true,
+  },
+});
+```
+
+### Path Syntax
+
+Redaction paths support dot notation and wildcards:
+
+```typescript
+redact: [
+  'password',           // Top-level field
+  'user.password',      // Nested field
+  'users[*].password',  // Array wildcard
+  '*.secret',           // Any object's 'secret' field
+  'headers["x-api-key"]', // Bracket notation for special chars
+]
+```
+
 ## API Reference
 
 ### Logger Interface

package/dist/console.cjs

@@ -17,11 +17,19 @@ var ConsoleLogger = class ConsoleLogger {
 	* @private
 	*/
 	createLogFn(logMethod) {
-		return (obj, msg, ...args) => {
+		return (objOrMsg, msg, ...args) => {
 			const ts = Date.now();
+			if (typeof objOrMsg === "string") {
+				const mergedData$1 = {
+					...this.data,
+					ts
+				};
+				logMethod(mergedData$1, objOrMsg, ...args);
+				return;
+			}
 			const mergedData = {
 				...this.data,
-				...obj,
+				...objOrMsg,
 				ts
 			};
 			if (msg) logMethod(mergedData, msg, ...args);
@@ -87,8 +95,26 @@ var ConsoleLogger = class ConsoleLogger {
 * ```
 */
 const DEFAULT_LOGGER = new ConsoleLogger();
+/**
+* Creates a console logger with the same API as pino's createLogger.
+*
+* @param options - Logger configuration options
+* @returns A ConsoleLogger instance
+*
+* @example
+* ```typescript
+* import { createLogger } from '@geekmidas/logger/console';
+*
+* const logger = createLogger({ level: LogLevel.Debug });
+* logger.info({ action: 'start' }, 'Application starting');
+* ```
+*/
+function createLogger(options = {}) {
+	return new ConsoleLogger();
+}
 
 //#endregion
 exports.ConsoleLogger = ConsoleLogger;
 exports.DEFAULT_LOGGER = DEFAULT_LOGGER;
+exports.createLogger = createLogger;
 //# sourceMappingURL=console.cjs.map

package/dist/console.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"console.cjs","names":["data: object","logMethod: (...args: any[]) => void","obj: T","msg?: string","obj: object"],"sources":["../src/console.ts"],"sourcesContent":["import type { LogFn, Logger } from './types';\n\nexport class ConsoleLogger implements Logger {\n  /**\n   * Creates a new ConsoleLogger instance.\n   *\n   * @param data - Initial context data to include in all log messages\n   */\n  constructor(readonly data: object = {}) {}\n\n  /**\n   * Creates a logging function that merges context data and adds timestamps.\n   *\n   * @param logMethod - The console method to use (e.g., console.log, console.error)\n   * @returns A LogFn that handles both structured and simple logging\n   * @private\n   */\n  private createLogFn(logMethod: (...args: any[]) => void): LogFn {\n    return <T extends object>(obj: T, msg?: string, ...args: any[]): void => {\n      // Merge the logger's context data with the provided object\n      const ts = Date.now();\n      const mergedData = { ...this.data, ...obj, ts };\n\n      if (msg) {\n        logMethod(mergedData, msg, ...args);\n      } else {\n        logMethod(mergedData, ...args);\n      }\n    };\n  }\n\n  /** Debug level logging function */\n  debug: LogFn = this.createLogFn(console.debug.bind(console));\n  /** Info level logging function */\n  info: LogFn = this.createLogFn(console.info.bind(console));\n  /** Warning level logging function */\n  warn: LogFn = this.createLogFn(console.warn.bind(console));\n  /** Error level logging function */\n  error: LogFn = this.createLogFn(console.error.bind(console));\n  /** Fatal level logging function (uses console.error) */\n  fatal: LogFn = this.createLogFn(console.error.bind(console));\n  /** Trace level logging function */\n  trace: LogFn = this.createLogFn(console.trace.bind(console));\n\n  /**\n   * Creates a child logger with additional context data.\n   * The child logger inherits all context from the parent and adds its own.\n   *\n   * @param obj - Additional context data for the child logger\n   * @returns A new ConsoleLogger instance with merged context\n   *\n   * @example\n   * ```typescript\n   * const parentLogger = new ConsoleLogger({ app: 'myApp' });\n   * const childLogger = parentLogger.child({ module: 'database' });\n   * childLogger.info({ query: 'SELECT * FROM users' }, 'Query executed');\n   * // Context includes both { app: 'myApp' } and { module: 'database' }\n   * ```\n   */\n  child(obj: object): Logger {\n    return new ConsoleLogger({\n      ...this.data,\n      ...obj,\n    });\n  }\n}\n\n/**\n * @example Basic usage\n * ```typescript\n * const logger = new ConsoleLogger({ app: 'myApp' });\n * logger.info({ action: 'start' }, 'Application starting');\n * // Logs: { app: 'myApp', action: 'start', ts: 1234567890 } Application starting\n * ```\n *\n * @example Child logger usage\n * ```typescript\n * const childLogger = logger.child({ module: 'auth' });\n * childLogger.debug({ userId: 123 }, 'User authenticated');\n * // Logs: { app: 'myApp', module: 'auth', userId: 123, ts: 1234567891 } User authenticated\n * ```\n *\n * @example Error logging with context\n * ```typescript\n * try {\n *   await someOperation();\n * } catch (error) {\n *   logger.error({ error, operation: 'someOperation' }, 'Operation failed');\n * }\n * ```\n */\n\nexport const DEFAULT_LOGGER = new ConsoleLogger() as any;\n"],"mappings":";;AAEA,IAAa,gBAAb,MAAa,cAAgC;;;;;;CAM3C,YAAqBA,OAAe,CAAE,GAAE;EAAnB;CAAqB;;;;;;;;CAS1C,AAAQ,YAAYC,WAA4C;AAC9D,SAAO,CAAmBC,KAAQC,KAAc,GAAG,SAAsB;GAEvE,MAAM,KAAK,KAAK,KAAK;GACrB,MAAM,aAAa;IAAE,GAAG,KAAK;IAAM,GAAG;IAAK;GAAI;AAE/C,OAAI,IACF,WAAU,YAAY,KAAK,GAAG,KAAK;OAEnC,WAAU,YAAY,GAAG,KAAK;EAEjC;CACF;;CAGD,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,OAAc,KAAK,YAAY,QAAQ,KAAK,KAAK,QAAQ,CAAC;;CAE1D,OAAc,KAAK,YAAY,QAAQ,KAAK,KAAK,QAAQ,CAAC;;CAE1D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;;;;;;;;;;;;;;;CAiB5D,MAAMC,KAAqB;AACzB,SAAO,IAAI,cAAc;GACvB,GAAG,KAAK;GACR,GAAG;EACJ;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;AA2BD,MAAa,iBAAiB,IAAI"}
+{"version":3,"file":"console.cjs","names":["data: object","logMethod: (...args: any[]) => void","objOrMsg: T | string","msg?: string","mergedData","obj: object","options: CreateLoggerOptions"],"sources":["../src/console.ts"],"sourcesContent":["import type { CreateLoggerOptions, LogFn, Logger } from './types';\n\nexport class ConsoleLogger implements Logger {\n  /**\n   * Creates a new ConsoleLogger instance.\n   *\n   * @param data - Initial context data to include in all log messages\n   */\n  constructor(readonly data: object = {}) {}\n\n  /**\n   * Creates a logging function that merges context data and adds timestamps.\n   *\n   * @param logMethod - The console method to use (e.g., console.log, console.error)\n   * @returns A LogFn that handles both structured and simple logging\n   * @private\n   */\n  private createLogFn(logMethod: (...args: any[]) => void): LogFn {\n    return <T extends object>(\n      objOrMsg: T | string,\n      msg?: string,\n      ...args: any[]\n    ): void => {\n      const ts = Date.now();\n\n      // Handle simple string logging: logger.info('message')\n      if (typeof objOrMsg === 'string') {\n        const mergedData = { ...this.data, ts };\n        logMethod(mergedData, objOrMsg, ...args);\n        return;\n      }\n\n      // Handle structured logging: logger.info({ data }, 'message')\n      const mergedData = { ...this.data, ...objOrMsg, ts };\n      if (msg) {\n        logMethod(mergedData, msg, ...args);\n      } else {\n        logMethod(mergedData, ...args);\n      }\n    };\n  }\n\n  /** Debug level logging function */\n  debug: LogFn = this.createLogFn(console.debug.bind(console));\n  /** Info level logging function */\n  info: LogFn = this.createLogFn(console.info.bind(console));\n  /** Warning level logging function */\n  warn: LogFn = this.createLogFn(console.warn.bind(console));\n  /** Error level logging function */\n  error: LogFn = this.createLogFn(console.error.bind(console));\n  /** Fatal level logging function (uses console.error) */\n  fatal: LogFn = this.createLogFn(console.error.bind(console));\n  /** Trace level logging function */\n  trace: LogFn = this.createLogFn(console.trace.bind(console));\n\n  /**\n   * Creates a child logger with additional context data.\n   * The child logger inherits all context from the parent and adds its own.\n   *\n   * @param obj - Additional context data for the child logger\n   * @returns A new ConsoleLogger instance with merged context\n   *\n   * @example\n   * ```typescript\n   * const parentLogger = new ConsoleLogger({ app: 'myApp' });\n   * const childLogger = parentLogger.child({ module: 'database' });\n   * childLogger.info({ query: 'SELECT * FROM users' }, 'Query executed');\n   * // Context includes both { app: 'myApp' } and { module: 'database' }\n   * ```\n   */\n  child(obj: object): Logger {\n    return new ConsoleLogger({\n      ...this.data,\n      ...obj,\n    });\n  }\n}\n\n/**\n * @example Basic usage\n * ```typescript\n * const logger = new ConsoleLogger({ app: 'myApp' });\n * logger.info({ action: 'start' }, 'Application starting');\n * // Logs: { app: 'myApp', action: 'start', ts: 1234567890 } Application starting\n * ```\n *\n * @example Child logger usage\n * ```typescript\n * const childLogger = logger.child({ module: 'auth' });\n * childLogger.debug({ userId: 123 }, 'User authenticated');\n * // Logs: { app: 'myApp', module: 'auth', userId: 123, ts: 1234567891 } User authenticated\n * ```\n *\n * @example Error logging with context\n * ```typescript\n * try {\n *   await someOperation();\n * } catch (error) {\n *   logger.error({ error, operation: 'someOperation' }, 'Operation failed');\n * }\n * ```\n */\n\nexport const DEFAULT_LOGGER = new ConsoleLogger() as any;\n\n/**\n * Creates a console logger with the same API as pino's createLogger.\n *\n * @param options - Logger configuration options\n * @returns A ConsoleLogger instance\n *\n * @example\n * ```typescript\n * import { createLogger } from '@geekmidas/logger/console';\n *\n * const logger = createLogger({ level: LogLevel.Debug });\n * logger.info({ action: 'start' }, 'Application starting');\n * ```\n */\nexport function createLogger(options: CreateLoggerOptions = {}): Logger {\n  return new ConsoleLogger();\n}\n"],"mappings":";;AAEA,IAAa,gBAAb,MAAa,cAAgC;;;;;;CAM3C,YAAqBA,OAAe,CAAE,GAAE;EAAnB;CAAqB;;;;;;;;CAS1C,AAAQ,YAAYC,WAA4C;AAC9D,SAAO,CACLC,UACAC,KACA,GAAG,SACM;GACT,MAAM,KAAK,KAAK,KAAK;AAGrB,cAAW,aAAa,UAAU;IAChC,MAAMC,eAAa;KAAE,GAAG,KAAK;KAAM;IAAI;AACvC,cAAUA,cAAY,UAAU,GAAG,KAAK;AACxC;GACD;GAGD,MAAM,aAAa;IAAE,GAAG,KAAK;IAAM,GAAG;IAAU;GAAI;AACpD,OAAI,IACF,WAAU,YAAY,KAAK,GAAG,KAAK;OAEnC,WAAU,YAAY,GAAG,KAAK;EAEjC;CACF;;CAGD,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,OAAc,KAAK,YAAY,QAAQ,KAAK,KAAK,QAAQ,CAAC;;CAE1D,OAAc,KAAK,YAAY,QAAQ,KAAK,KAAK,QAAQ,CAAC;;CAE1D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;;;;;;;;;;;;;;;CAiB5D,MAAMC,KAAqB;AACzB,SAAO,IAAI,cAAc;GACvB,GAAG,KAAK;GACR,GAAG;EACJ;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;AA2BD,MAAa,iBAAiB,IAAI;;;;;;;;;;;;;;;AAgBlC,SAAgB,aAAaC,UAA+B,CAAE,GAAU;AACtE,QAAO,IAAI;AACZ"}

package/dist/console.d.cts

@@ -1,4 +1,4 @@
-import { LogFn, Logger } from "./types-DXdmn7h5.cjs";
+import { CreateLoggerOptions, LogFn, Logger } from "./types-JxCFymH0.cjs";
 
 //#region src/console.d.ts
 declare class ConsoleLogger implements Logger {
@@ -71,6 +71,21 @@ declare class ConsoleLogger implements Logger {
  * ```
  */
 declare const DEFAULT_LOGGER: any;
+/**
+ * Creates a console logger with the same API as pino's createLogger.
+ *
+ * @param options - Logger configuration options
+ * @returns A ConsoleLogger instance
+ *
+ * @example
+ * ```typescript
+ * import { createLogger } from '@geekmidas/logger/console';
+ *
+ * const logger = createLogger({ level: LogLevel.Debug });
+ * logger.info({ action: 'start' }, 'Application starting');
+ * ```
+ */
+declare function createLogger(options?: CreateLoggerOptions): Logger;
 //#endregion
-export { ConsoleLogger, DEFAULT_LOGGER };
+export { ConsoleLogger, DEFAULT_LOGGER, createLogger };
 //# sourceMappingURL=console.d.cts.map

package/dist/console.d.mts

@@ -1,4 +1,4 @@
-import { LogFn, Logger } from "./types-C1RfRbo6.mjs";
+import { CreateLoggerOptions, LogFn, Logger } from "./types-BFiJzL9N.mjs";
 
 //#region src/console.d.ts
 declare class ConsoleLogger implements Logger {
@@ -71,6 +71,21 @@ declare class ConsoleLogger implements Logger {
  * ```
  */
 declare const DEFAULT_LOGGER: any;
+/**
+ * Creates a console logger with the same API as pino's createLogger.
+ *
+ * @param options - Logger configuration options
+ * @returns A ConsoleLogger instance
+ *
+ * @example
+ * ```typescript
+ * import { createLogger } from '@geekmidas/logger/console';
+ *
+ * const logger = createLogger({ level: LogLevel.Debug });
+ * logger.info({ action: 'start' }, 'Application starting');
+ * ```
+ */
+declare function createLogger(options?: CreateLoggerOptions): Logger;
 //#endregion
-export { ConsoleLogger, DEFAULT_LOGGER };
+export { ConsoleLogger, DEFAULT_LOGGER, createLogger };
 //# sourceMappingURL=console.d.mts.map

package/dist/console.mjs

@@ -16,11 +16,19 @@ var ConsoleLogger = class ConsoleLogger {
 	* @private
 	*/
 	createLogFn(logMethod) {
-		return (obj, msg, ...args) => {
+		return (objOrMsg, msg, ...args) => {
 			const ts = Date.now();
+			if (typeof objOrMsg === "string") {
+				const mergedData$1 = {
+					...this.data,
+					ts
+				};
+				logMethod(mergedData$1, objOrMsg, ...args);
+				return;
+			}
 			const mergedData = {
 				...this.data,
-				...obj,
+				...objOrMsg,
 				ts
 			};
 			if (msg) logMethod(mergedData, msg, ...args);
@@ -86,7 +94,24 @@ var ConsoleLogger = class ConsoleLogger {
 * ```
 */
 const DEFAULT_LOGGER = new ConsoleLogger();
+/**
+* Creates a console logger with the same API as pino's createLogger.
+*
+* @param options - Logger configuration options
+* @returns A ConsoleLogger instance
+*
+* @example
+* ```typescript
+* import { createLogger } from '@geekmidas/logger/console';
+*
+* const logger = createLogger({ level: LogLevel.Debug });
+* logger.info({ action: 'start' }, 'Application starting');
+* ```
+*/
+function createLogger(options = {}) {
+	return new ConsoleLogger();
+}
 
 //#endregion
-export { ConsoleLogger, DEFAULT_LOGGER };
+export { ConsoleLogger, DEFAULT_LOGGER, createLogger };
 //# sourceMappingURL=console.mjs.map

package/dist/console.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"console.mjs","names":["data: object","logMethod: (...args: any[]) => void","obj: T","msg?: string","obj: object"],"sources":["../src/console.ts"],"sourcesContent":["import type { LogFn, Logger } from './types';\n\nexport class ConsoleLogger implements Logger {\n  /**\n   * Creates a new ConsoleLogger instance.\n   *\n   * @param data - Initial context data to include in all log messages\n   */\n  constructor(readonly data: object = {}) {}\n\n  /**\n   * Creates a logging function that merges context data and adds timestamps.\n   *\n   * @param logMethod - The console method to use (e.g., console.log, console.error)\n   * @returns A LogFn that handles both structured and simple logging\n   * @private\n   */\n  private createLogFn(logMethod: (...args: any[]) => void): LogFn {\n    return <T extends object>(obj: T, msg?: string, ...args: any[]): void => {\n      // Merge the logger's context data with the provided object\n      const ts = Date.now();\n      const mergedData = { ...this.data, ...obj, ts };\n\n      if (msg) {\n        logMethod(mergedData, msg, ...args);\n      } else {\n        logMethod(mergedData, ...args);\n      }\n    };\n  }\n\n  /** Debug level logging function */\n  debug: LogFn = this.createLogFn(console.debug.bind(console));\n  /** Info level logging function */\n  info: LogFn = this.createLogFn(console.info.bind(console));\n  /** Warning level logging function */\n  warn: LogFn = this.createLogFn(console.warn.bind(console));\n  /** Error level logging function */\n  error: LogFn = this.createLogFn(console.error.bind(console));\n  /** Fatal level logging function (uses console.error) */\n  fatal: LogFn = this.createLogFn(console.error.bind(console));\n  /** Trace level logging function */\n  trace: LogFn = this.createLogFn(console.trace.bind(console));\n\n  /**\n   * Creates a child logger with additional context data.\n   * The child logger inherits all context from the parent and adds its own.\n   *\n   * @param obj - Additional context data for the child logger\n   * @returns A new ConsoleLogger instance with merged context\n   *\n   * @example\n   * ```typescript\n   * const parentLogger = new ConsoleLogger({ app: 'myApp' });\n   * const childLogger = parentLogger.child({ module: 'database' });\n   * childLogger.info({ query: 'SELECT * FROM users' }, 'Query executed');\n   * // Context includes both { app: 'myApp' } and { module: 'database' }\n   * ```\n   */\n  child(obj: object): Logger {\n    return new ConsoleLogger({\n      ...this.data,\n      ...obj,\n    });\n  }\n}\n\n/**\n * @example Basic usage\n * ```typescript\n * const logger = new ConsoleLogger({ app: 'myApp' });\n * logger.info({ action: 'start' }, 'Application starting');\n * // Logs: { app: 'myApp', action: 'start', ts: 1234567890 } Application starting\n * ```\n *\n * @example Child logger usage\n * ```typescript\n * const childLogger = logger.child({ module: 'auth' });\n * childLogger.debug({ userId: 123 }, 'User authenticated');\n * // Logs: { app: 'myApp', module: 'auth', userId: 123, ts: 1234567891 } User authenticated\n * ```\n *\n * @example Error logging with context\n * ```typescript\n * try {\n *   await someOperation();\n * } catch (error) {\n *   logger.error({ error, operation: 'someOperation' }, 'Operation failed');\n * }\n * ```\n */\n\nexport const DEFAULT_LOGGER = new ConsoleLogger() as any;\n"],"mappings":";AAEA,IAAa,gBAAb,MAAa,cAAgC;;;;;;CAM3C,YAAqBA,OAAe,CAAE,GAAE;EAAnB;CAAqB;;;;;;;;CAS1C,AAAQ,YAAYC,WAA4C;AAC9D,SAAO,CAAmBC,KAAQC,KAAc,GAAG,SAAsB;GAEvE,MAAM,KAAK,KAAK,KAAK;GACrB,MAAM,aAAa;IAAE,GAAG,KAAK;IAAM,GAAG;IAAK;GAAI;AAE/C,OAAI,IACF,WAAU,YAAY,KAAK,GAAG,KAAK;OAEnC,WAAU,YAAY,GAAG,KAAK;EAEjC;CACF;;CAGD,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,OAAc,KAAK,YAAY,QAAQ,KAAK,KAAK,QAAQ,CAAC;;CAE1D,OAAc,KAAK,YAAY,QAAQ,KAAK,KAAK,QAAQ,CAAC;;CAE1D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;;;;;;;;;;;;;;;CAiB5D,MAAMC,KAAqB;AACzB,SAAO,IAAI,cAAc;GACvB,GAAG,KAAK;GACR,GAAG;EACJ;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;AA2BD,MAAa,iBAAiB,IAAI"}
+{"version":3,"file":"console.mjs","names":["data: object","logMethod: (...args: any[]) => void","objOrMsg: T | string","msg?: string","mergedData","obj: object","options: CreateLoggerOptions"],"sources":["../src/console.ts"],"sourcesContent":["import type { CreateLoggerOptions, LogFn, Logger } from './types';\n\nexport class ConsoleLogger implements Logger {\n  /**\n   * Creates a new ConsoleLogger instance.\n   *\n   * @param data - Initial context data to include in all log messages\n   */\n  constructor(readonly data: object = {}) {}\n\n  /**\n   * Creates a logging function that merges context data and adds timestamps.\n   *\n   * @param logMethod - The console method to use (e.g., console.log, console.error)\n   * @returns A LogFn that handles both structured and simple logging\n   * @private\n   */\n  private createLogFn(logMethod: (...args: any[]) => void): LogFn {\n    return <T extends object>(\n      objOrMsg: T | string,\n      msg?: string,\n      ...args: any[]\n    ): void => {\n      const ts = Date.now();\n\n      // Handle simple string logging: logger.info('message')\n      if (typeof objOrMsg === 'string') {\n        const mergedData = { ...this.data, ts };\n        logMethod(mergedData, objOrMsg, ...args);\n        return;\n      }\n\n      // Handle structured logging: logger.info({ data }, 'message')\n      const mergedData = { ...this.data, ...objOrMsg, ts };\n      if (msg) {\n        logMethod(mergedData, msg, ...args);\n      } else {\n        logMethod(mergedData, ...args);\n      }\n    };\n  }\n\n  /** Debug level logging function */\n  debug: LogFn = this.createLogFn(console.debug.bind(console));\n  /** Info level logging function */\n  info: LogFn = this.createLogFn(console.info.bind(console));\n  /** Warning level logging function */\n  warn: LogFn = this.createLogFn(console.warn.bind(console));\n  /** Error level logging function */\n  error: LogFn = this.createLogFn(console.error.bind(console));\n  /** Fatal level logging function (uses console.error) */\n  fatal: LogFn = this.createLogFn(console.error.bind(console));\n  /** Trace level logging function */\n  trace: LogFn = this.createLogFn(console.trace.bind(console));\n\n  /**\n   * Creates a child logger with additional context data.\n   * The child logger inherits all context from the parent and adds its own.\n   *\n   * @param obj - Additional context data for the child logger\n   * @returns A new ConsoleLogger instance with merged context\n   *\n   * @example\n   * ```typescript\n   * const parentLogger = new ConsoleLogger({ app: 'myApp' });\n   * const childLogger = parentLogger.child({ module: 'database' });\n   * childLogger.info({ query: 'SELECT * FROM users' }, 'Query executed');\n   * // Context includes both { app: 'myApp' } and { module: 'database' }\n   * ```\n   */\n  child(obj: object): Logger {\n    return new ConsoleLogger({\n      ...this.data,\n      ...obj,\n    });\n  }\n}\n\n/**\n * @example Basic usage\n * ```typescript\n * const logger = new ConsoleLogger({ app: 'myApp' });\n * logger.info({ action: 'start' }, 'Application starting');\n * // Logs: { app: 'myApp', action: 'start', ts: 1234567890 } Application starting\n * ```\n *\n * @example Child logger usage\n * ```typescript\n * const childLogger = logger.child({ module: 'auth' });\n * childLogger.debug({ userId: 123 }, 'User authenticated');\n * // Logs: { app: 'myApp', module: 'auth', userId: 123, ts: 1234567891 } User authenticated\n * ```\n *\n * @example Error logging with context\n * ```typescript\n * try {\n *   await someOperation();\n * } catch (error) {\n *   logger.error({ error, operation: 'someOperation' }, 'Operation failed');\n * }\n * ```\n */\n\nexport const DEFAULT_LOGGER = new ConsoleLogger() as any;\n\n/**\n * Creates a console logger with the same API as pino's createLogger.\n *\n * @param options - Logger configuration options\n * @returns A ConsoleLogger instance\n *\n * @example\n * ```typescript\n * import { createLogger } from '@geekmidas/logger/console';\n *\n * const logger = createLogger({ level: LogLevel.Debug });\n * logger.info({ action: 'start' }, 'Application starting');\n * ```\n */\nexport function createLogger(options: CreateLoggerOptions = {}): Logger {\n  return new ConsoleLogger();\n}\n"],"mappings":";AAEA,IAAa,gBAAb,MAAa,cAAgC;;;;;;CAM3C,YAAqBA,OAAe,CAAE,GAAE;EAAnB;CAAqB;;;;;;;;CAS1C,AAAQ,YAAYC,WAA4C;AAC9D,SAAO,CACLC,UACAC,KACA,GAAG,SACM;GACT,MAAM,KAAK,KAAK,KAAK;AAGrB,cAAW,aAAa,UAAU;IAChC,MAAMC,eAAa;KAAE,GAAG,KAAK;KAAM;IAAI;AACvC,cAAUA,cAAY,UAAU,GAAG,KAAK;AACxC;GACD;GAGD,MAAM,aAAa;IAAE,GAAG,KAAK;IAAM,GAAG;IAAU;GAAI;AACpD,OAAI,IACF,WAAU,YAAY,KAAK,GAAG,KAAK;OAEnC,WAAU,YAAY,GAAG,KAAK;EAEjC;CACF;;CAGD,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,OAAc,KAAK,YAAY,QAAQ,KAAK,KAAK,QAAQ,CAAC;;CAE1D,OAAc,KAAK,YAAY,QAAQ,KAAK,KAAK,QAAQ,CAAC;;CAE1D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;CAE5D,QAAe,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ,CAAC;;;;;;;;;;;;;;;;CAiB5D,MAAMC,KAAqB;AACzB,SAAO,IAAI,cAAc;GACvB,GAAG,KAAK;GACR,GAAG;EACJ;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;AA2BD,MAAa,iBAAiB,IAAI;;;;;;;;;;;;;;;AAgBlC,SAAgB,aAAaC,UAA+B,CAAE,GAAU;AACtE,QAAO,IAAI;AACZ"}

package/dist/index.d.cts

@@ -1,2 +1,2 @@
-import { CreateLoggerOptions, LogFn, LogLevel, Logger } from "./types-DXdmn7h5.cjs";
-export { CreateLoggerOptions, LogFn, LogLevel, Logger };
+import { CreateLoggerOptions, LogFn, LogLevel, Logger, RedactOptions } from "./types-JxCFymH0.cjs";
+export { CreateLoggerOptions, LogFn, LogLevel, Logger, RedactOptions };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { CreateLoggerOptions, LogFn, LogLevel, Logger } from "./types-C1RfRbo6.mjs";
-export { CreateLoggerOptions, LogFn, LogLevel, Logger };
+import { CreateLoggerOptions, LogFn, LogLevel, Logger, RedactOptions } from "./types-BFiJzL9N.mjs";
+export { CreateLoggerOptions, LogFn, LogLevel, Logger, RedactOptions };

package/dist/pino.cjs

@@ -24,14 +24,115 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 const pino = __toESM(require("pino"));
 
 //#region src/pino.ts
-function createLogger(options) {
+/**
+* Default sensitive field paths for redaction.
+*
+* These paths are automatically used when `redact: true` is set,
+* and merged with custom paths unless `resolution: 'override'` is specified.
+*
+* Includes:
+* - Authentication: password, token, apiKey, authorization, credentials
+* - Headers: authorization, cookie, x-api-key, x-auth-token
+* - Personal data: ssn, creditCard, cvv, pin
+* - Secrets: secret, connectionString, databaseUrl
+* - Wildcards: *.password, *.secret, *.token (catches nested fields)
+*/
+const DEFAULT_REDACT_PATHS = [
+	"password",
+	"pass",
+	"passwd",
+	"secret",
+	"token",
+	"accessToken",
+	"refreshToken",
+	"idToken",
+	"apiKey",
+	"api_key",
+	"apikey",
+	"auth",
+	"authorization",
+	"credential",
+	"credentials",
+	"*.password",
+	"*.secret",
+	"*.token",
+	"*.apiKey",
+	"*.api_key",
+	"*.authorization",
+	"*.accessToken",
+	"*.refreshToken",
+	"headers.authorization",
+	"headers.Authorization",
+	"headers[\"authorization\"]",
+	"headers[\"Authorization\"]",
+	"headers.cookie",
+	"headers.Cookie",
+	"headers[\"x-api-key\"]",
+	"headers[\"X-Api-Key\"]",
+	"headers[\"x-auth-token\"]",
+	"headers[\"X-Auth-Token\"]",
+	"ssn",
+	"socialSecurityNumber",
+	"social_security_number",
+	"creditCard",
+	"credit_card",
+	"cardNumber",
+	"card_number",
+	"cvv",
+	"cvc",
+	"pin",
+	"connectionString",
+	"connection_string",
+	"databaseUrl",
+	"database_url"
+];
+/**
+* Resolves redaction configuration from options.
+* Returns undefined if redaction is disabled, or a pino-compatible redact config.
+*
+* By default (resolution: 'merge'), custom paths are merged with DEFAULT_REDACT_PATHS.
+* With resolution: 'override', only the custom paths are used.
+*/
+function resolveRedactConfig(redact) {
+	if (redact === void 0 || redact === false) return void 0;
+	if (redact === true) return DEFAULT_REDACT_PATHS;
+	if (Array.isArray(redact)) return [...DEFAULT_REDACT_PATHS, ...redact];
+	const { resolution = "merge", paths, censor, remove } = redact;
+	const resolvedPaths = resolution === "override" ? paths : [...DEFAULT_REDACT_PATHS, ...paths];
+	const config = { paths: resolvedPaths };
+	if (censor !== void 0) config.censor = censor;
+	if (remove !== void 0) config.remove = remove;
+	return config;
+}
+/**
+* Creates a pino logger instance with optional redaction support.
+*
+* @param options - Logger configuration options
+* @returns A configured pino logger instance
+*
+* @example
+* ```typescript
+* // Basic logger
+* const logger = createLogger({ level: 'debug' });
+*
+* // With redaction enabled
+* const secureLogger = createLogger({ redact: true });
+*
+* // Pretty printing in development
+* const devLogger = createLogger({ pretty: true, redact: true });
+* ```
+*/
+function createLogger(options = {}) {
 	const pretty = options?.pretty && process.NODE_ENV !== "production";
 	const baseOptions = pretty ? { transport: {
 		target: "pino-pretty",
 		options: { colorize: true }
 	} } : {};
+	const redact = resolveRedactConfig(options.redact);
 	return (0, pino.pino)({
 		...baseOptions,
+		...options.level && { level: options.level },
+		...redact && { redact },
 		formatters: {
 			bindings() {
 				return { nodeVersion: process.version };
@@ -44,5 +145,6 @@ function createLogger(options) {
 }
 
 //#endregion
+exports.DEFAULT_REDACT_PATHS = DEFAULT_REDACT_PATHS;
 exports.createLogger = createLogger;
 //# sourceMappingURL=pino.cjs.map

package/dist/pino.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pino.cjs","names":["options: CreateLoggerOptions"],"sources":["../src/pino.ts"],"sourcesContent":["import { pino } from 'pino';\nimport type { CreateLoggerOptions } from './types';\n\nexport function createLogger(options: CreateLoggerOptions) {\n  // @ts-ignore\n  const pretty = options?.pretty && process.NODE_ENV !== 'production';\n  const baseOptions = pretty\n    ? {\n        transport: {\n          target: 'pino-pretty',\n          options: { colorize: true },\n        },\n      }\n    : {};\n  return pino({\n    ...baseOptions,\n    formatters: {\n      bindings() {\n        return { nodeVersion: process.version };\n      },\n      level: (label) => {\n        return { level: label.toUpperCase() };\n      },\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,SAAgB,aAAaA,SAA8B;CAEzD,MAAM,SAAS,SAAS,UAAU,QAAQ,aAAa;CACvD,MAAM,cAAc,SAChB,EACE,WAAW;EACT,QAAQ;EACR,SAAS,EAAE,UAAU,KAAM;CAC5B,EACF,IACD,CAAE;AACN,QAAO,eAAK;EACV,GAAG;EACH,YAAY;GACV,WAAW;AACT,WAAO,EAAE,aAAa,QAAQ,QAAS;GACxC;GACD,OAAO,CAAC,UAAU;AAChB,WAAO,EAAE,OAAO,MAAM,aAAa,CAAE;GACtC;EACF;CACF,EAAC;AACH"}
+{"version":3,"file":"pino.cjs","names":["DEFAULT_REDACT_PATHS: string[]","redact: boolean | RedactOptions | undefined","config: PinoRedactConfig","options: CreateLoggerOptions"],"sources":["../src/pino.ts"],"sourcesContent":["/**\n * Pino logger with built-in redaction support for sensitive data.\n *\n * @example\n * ```typescript\n * import { createLogger, DEFAULT_REDACT_PATHS } from '@geekmidas/logger/pino';\n *\n * // Enable redaction with sensible defaults\n * const logger = createLogger({ redact: true });\n *\n * // Sensitive data is automatically masked\n * logger.info({ password: 'secret123', user: 'john' }, 'Login');\n * // Output: { password: '[Redacted]', user: 'john' } Login\n *\n * // Add custom paths (merged with defaults)\n * const logger2 = createLogger({ redact: ['user.ssn'] });\n *\n * // Override defaults for full control\n * const logger3 = createLogger({\n *   redact: {\n *     paths: ['onlyThis'],\n *     resolution: 'override',\n *   }\n * });\n * ```\n *\n * @module\n */\nimport { pino } from 'pino';\nimport type { CreateLoggerOptions, RedactOptions } from './types';\n\n/**\n * Default sensitive field paths for redaction.\n *\n * These paths are automatically used when `redact: true` is set,\n * and merged with custom paths unless `resolution: 'override'` is specified.\n *\n * Includes:\n * - Authentication: password, token, apiKey, authorization, credentials\n * - Headers: authorization, cookie, x-api-key, x-auth-token\n * - Personal data: ssn, creditCard, cvv, pin\n * - Secrets: secret, connectionString, databaseUrl\n * - Wildcards: *.password, *.secret, *.token (catches nested fields)\n */\nexport const DEFAULT_REDACT_PATHS: string[] = [\n  // Authentication & authorization\n  'password',\n  'pass',\n  'passwd',\n  'secret',\n  'token',\n  'accessToken',\n  'refreshToken',\n  'idToken',\n  'apiKey',\n  'api_key',\n  'apikey',\n  'auth',\n  'authorization',\n  'credential',\n  'credentials',\n\n  // Common nested patterns (headers, body, etc.)\n  '*.password',\n  '*.secret',\n  '*.token',\n  '*.apiKey',\n  '*.api_key',\n  '*.authorization',\n  '*.accessToken',\n  '*.refreshToken',\n\n  // HTTP headers (case variations)\n  'headers.authorization',\n  'headers.Authorization',\n  'headers[\"authorization\"]',\n  'headers[\"Authorization\"]',\n  'headers.cookie',\n  'headers.Cookie',\n  'headers[\"x-api-key\"]',\n  'headers[\"X-Api-Key\"]',\n  'headers[\"x-auth-token\"]',\n  'headers[\"X-Auth-Token\"]',\n\n  // Common sensitive data fields\n  'ssn',\n  'socialSecurityNumber',\n  'social_security_number',\n  'creditCard',\n  'credit_card',\n  'cardNumber',\n  'card_number',\n  'cvv',\n  'cvc',\n  'pin',\n\n  // Database & connection strings\n  'connectionString',\n  'connection_string',\n  'databaseUrl',\n  'database_url',\n];\n\n/**\n * Type for the resolved pino redact config (without our custom resolution field).\n */\ntype PinoRedactConfig =\n  | string[]\n  | {\n      paths: string[];\n      censor?: string | ((value: unknown, path: string[]) => unknown);\n      remove?: boolean;\n    };\n\n/**\n * Resolves redaction configuration from options.\n * Returns undefined if redaction is disabled, or a pino-compatible redact config.\n *\n * By default (resolution: 'merge'), custom paths are merged with DEFAULT_REDACT_PATHS.\n * With resolution: 'override', only the custom paths are used.\n */\nfunction resolveRedactConfig(\n  redact: boolean | RedactOptions | undefined,\n): PinoRedactConfig | undefined {\n  if (redact === undefined || redact === false) {\n    return undefined;\n  }\n\n  if (redact === true) {\n    return DEFAULT_REDACT_PATHS;\n  }\n\n  // Array syntax - merge with defaults\n  if (Array.isArray(redact)) {\n    return [...DEFAULT_REDACT_PATHS, ...redact];\n  }\n\n  // Object syntax - check resolution mode\n  const { resolution = 'merge', paths, censor, remove } = redact;\n\n  const resolvedPaths =\n    resolution === 'override' ? paths : [...DEFAULT_REDACT_PATHS, ...paths];\n\n  // Return clean pino config without our resolution field\n  const config: PinoRedactConfig = { paths: resolvedPaths };\n  if (censor !== undefined) config.censor = censor;\n  if (remove !== undefined) config.remove = remove;\n\n  return config;\n}\n\n/**\n * Creates a pino logger instance with optional redaction support.\n *\n * @param options - Logger configuration options\n * @returns A configured pino logger instance\n *\n * @example\n * ```typescript\n * // Basic logger\n * const logger = createLogger({ level: 'debug' });\n *\n * // With redaction enabled\n * const secureLogger = createLogger({ redact: true });\n *\n * // Pretty printing in development\n * const devLogger = createLogger({ pretty: true, redact: true });\n * ```\n */\nexport function createLogger(options: CreateLoggerOptions = {}) {\n  // @ts-ignore\n  const pretty = options?.pretty && process.NODE_ENV !== 'production';\n  const baseOptions = pretty\n    ? {\n        transport: {\n          target: 'pino-pretty',\n          options: { colorize: true },\n        },\n      }\n    : {};\n\n  const redact = resolveRedactConfig(options.redact);\n\n  return pino({\n    ...baseOptions,\n    ...(options.level && { level: options.level }),\n    ...(redact && { redact }),\n    formatters: {\n      bindings() {\n        return { nodeVersion: process.version };\n      },\n      level: (label) => {\n        return { level: label.toUpperCase() };\n      },\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAaA,uBAAiC;CAE5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;AACD;;;;;;;;AAoBD,SAAS,oBACPC,QAC8B;AAC9B,KAAI,qBAAwB,WAAW,MACrC;AAGF,KAAI,WAAW,KACb,QAAO;AAIT,KAAI,MAAM,QAAQ,OAAO,CACvB,QAAO,CAAC,GAAG,sBAAsB,GAAG,MAAO;CAI7C,MAAM,EAAE,aAAa,SAAS,OAAO,QAAQ,QAAQ,GAAG;CAExD,MAAM,gBACJ,eAAe,aAAa,QAAQ,CAAC,GAAG,sBAAsB,GAAG,KAAM;CAGzE,MAAMC,SAA2B,EAAE,OAAO,cAAe;AACzD,KAAI,kBAAsB,QAAO,SAAS;AAC1C,KAAI,kBAAsB,QAAO,SAAS;AAE1C,QAAO;AACR;;;;;;;;;;;;;;;;;;;AAoBD,SAAgB,aAAaC,UAA+B,CAAE,GAAE;CAE9D,MAAM,SAAS,SAAS,UAAU,QAAQ,aAAa;CACvD,MAAM,cAAc,SAChB,EACE,WAAW;EACT,QAAQ;EACR,SAAS,EAAE,UAAU,KAAM;CAC5B,EACF,IACD,CAAE;CAEN,MAAM,SAAS,oBAAoB,QAAQ,OAAO;AAElD,QAAO,eAAK;EACV,GAAG;EACH,GAAI,QAAQ,SAAS,EAAE,OAAO,QAAQ,MAAO;EAC7C,GAAI,UAAU,EAAE,OAAQ;EACxB,YAAY;GACV,WAAW;AACT,WAAO,EAAE,aAAa,QAAQ,QAAS;GACxC;GACD,OAAO,CAAC,UAAU;AAChB,WAAO,EAAE,OAAO,MAAM,aAAa,CAAE;GACtC;EACF;CACF,EAAC;AACH"}

package/dist/pino.d.cts

@@ -1,8 +1,41 @@
-import { CreateLoggerOptions } from "./types-DXdmn7h5.cjs";
+import { CreateLoggerOptions } from "./types-JxCFymH0.cjs";
 import * as pino0 from "pino";
 
 //#region src/pino.d.ts
-declare function createLogger(options: CreateLoggerOptions): pino0.Logger<never, boolean>;
+
+/**
+ * Default sensitive field paths for redaction.
+ *
+ * These paths are automatically used when `redact: true` is set,
+ * and merged with custom paths unless `resolution: 'override'` is specified.
+ *
+ * Includes:
+ * - Authentication: password, token, apiKey, authorization, credentials
+ * - Headers: authorization, cookie, x-api-key, x-auth-token
+ * - Personal data: ssn, creditCard, cvv, pin
+ * - Secrets: secret, connectionString, databaseUrl
+ * - Wildcards: *.password, *.secret, *.token (catches nested fields)
+ */
+declare const DEFAULT_REDACT_PATHS: string[];
+/**
+ * Creates a pino logger instance with optional redaction support.
+ *
+ * @param options - Logger configuration options
+ * @returns A configured pino logger instance
+ *
+ * @example
+ * ```typescript
+ * // Basic logger
+ * const logger = createLogger({ level: 'debug' });
+ *
+ * // With redaction enabled
+ * const secureLogger = createLogger({ redact: true });
+ *
+ * // Pretty printing in development
+ * const devLogger = createLogger({ pretty: true, redact: true });
+ * ```
+ */
+declare function createLogger(options?: CreateLoggerOptions): pino0.Logger<never, boolean>;
 //#endregion
-export { createLogger };
+export { DEFAULT_REDACT_PATHS, createLogger };
 //# sourceMappingURL=pino.d.cts.map

package/dist/pino.d.mts

@@ -1,8 +1,41 @@
-import { CreateLoggerOptions } from "./types-C1RfRbo6.mjs";
+import { CreateLoggerOptions } from "./types-BFiJzL9N.mjs";
 import * as pino0 from "pino";
 
 //#region src/pino.d.ts
-declare function createLogger(options: CreateLoggerOptions): pino0.Logger<never, boolean>;
+
+/**
+ * Default sensitive field paths for redaction.
+ *
+ * These paths are automatically used when `redact: true` is set,
+ * and merged with custom paths unless `resolution: 'override'` is specified.
+ *
+ * Includes:
+ * - Authentication: password, token, apiKey, authorization, credentials
+ * - Headers: authorization, cookie, x-api-key, x-auth-token
+ * - Personal data: ssn, creditCard, cvv, pin
+ * - Secrets: secret, connectionString, databaseUrl
+ * - Wildcards: *.password, *.secret, *.token (catches nested fields)
+ */
+declare const DEFAULT_REDACT_PATHS: string[];
+/**
+ * Creates a pino logger instance with optional redaction support.
+ *
+ * @param options - Logger configuration options
+ * @returns A configured pino logger instance
+ *
+ * @example
+ * ```typescript
+ * // Basic logger
+ * const logger = createLogger({ level: 'debug' });
+ *
+ * // With redaction enabled
+ * const secureLogger = createLogger({ redact: true });
+ *
+ * // Pretty printing in development
+ * const devLogger = createLogger({ pretty: true, redact: true });
+ * ```
+ */
+declare function createLogger(options?: CreateLoggerOptions): pino0.Logger<never, boolean>;
 //#endregion
-export { createLogger };
+export { DEFAULT_REDACT_PATHS, createLogger };
 //# sourceMappingURL=pino.d.mts.map