@togatherlabs/shared-utils 1.0.10 → 1.1.0

package/README.md

@@ -1,175 +1,250 @@
 # @togatherlabs/shared-utils
 
-A collection of **shared TypeScript utilities, constants, and types** used across ToGather microservices.
+Shared utilities library for Togather services, providing production-grade utilities including logger, validators, and common helpers.
 
-[![npm package](https://img.shields.io/npm/v/@togatherlabs/shared-utils.svg)](https://www.npmjs.com/package/@togatherlabs/shared-utils)
-[![npm downloads](https://img.shields.io/npm/dm/@togatherlabs/shared-utils.svg)](https://www.npmjs.com/package/@togatherlabs/shared-utils)
-[![license](https://img.shields.io/npm/l/@togatherlabs/shared-utils.svg)](./LICENSE)
+## 📦 Installation
 
-## Table of Contents
+```bash
+pnpm add @togatherlabs/shared-utils
+```
 
-1. [Directory Structure](#directory-structure)
-2. [Package Development](#package-development)
+## 🚀 Features
 
-   * [Adding New Utilities](#adding-new-utilities)
-   * [Linting](#linting)
-   * [Building](#building)
-   * [Publishing Package](#publishing-package)
-3. [Using the Utilities](#using-the-utilities)
+### Logger Module
+Production-ready logging built on [Pino](https://getpino.io/) with:
+- 🔒 Automatic sensitive data redaction
+- 📊 Structured logging with context
+- 🎨 Environment-aware (pretty dev logs, JSON production logs)
+- 🔧 Fully configurable
+- ⚡ High performance
 
-   * [TypeScript](#typescript)
-4. [Best Practices](#best-practices)
-5. [Troubleshooting](#troubleshooting)
-6. [License](#license)
+## 📚 Available Modules
 
-## Directory Structure
+### Logger
 
-The package follows a **clear folder structure** for maintainability:
+```typescript
+import { PinoLogger, ILogger } from '@togatherlabs/shared-utils/logger';
 
+const logger = new PinoLogger();
+
+logger.info({ label: 'app' }, 'Application started');
+logger.error({ err, label: 'database' }, 'Connection failed');
 ```
-src/
-├── constants/
-│   └── index.ts
-├── utils/
-│   └── index.ts
-├── types/
-│   └── index.ts
-└── index.ts
+
+**Full documentation**: [Logger README](./src/logger/README.md)
+
+## 🔧 Usage
+
+### Basic Import
+
+```typescript
+// Import from main entry point
+import { PinoLogger, ILogger } from '@togatherlabs/shared-utils';
+
+// Or import from specific module
+import { PinoLogger, ILogger } from '@togatherlabs/shared-utils/logger';
 ```
 
-* **constants**: Shared constants across services
-* **utils**: Reusable utility functions
-* **types**: Shared TypeScript types and interfaces
-* **index.ts**: Exports all public utilities
+### Environment Variables
 
-## Package Development
+**All environment variables are optional.** The logger works with sensible defaults:
 
-### Adding New Utilities
+- `NODE_ENV` - Set to `production` in production (default: `development`)
+- `SERVICE_NAME` - Your service name for log context (default: `undefined`)
+- `LOG_LEVEL` - Log level: `trace`, `debug`, `info`, `warn`, `error`, `fatal` (default: `info`)
+- `HOSTNAME` - Override hostname (default: OS hostname)
 
-1. Add your function, constant, or type in the appropriate folder (`utils`, `constants`, or `types`).
-2. Export it from the folder’s `index.ts`.
-3. Re-export from the root `index.ts` for public usage.
+See the [Logger README](./src/logger/README.md) for detailed configuration options.
 
-**Example:** Adding a new utility `capitalize`:
+### With Dependency Injection
 
-```ts
-// src/utils/capitalize.ts
-export function capitalize(str: string): string {
-  return str.charAt(0).toUpperCase() + str.slice(1);
-}
+```typescript
+import { injectable, inject } from 'inversify';
+import type { ILogger } from '@togatherlabs/shared-utils/logger';
 
-// src/utils/index.ts
-export * from './capitalize';
+@injectable()
+class UserService {
+  constructor(
+    @inject(TYPES.Logger) private logger: ILogger
+  ) {}
 
-// src/index.ts
-export * from './utils';
+  async createUser(data: CreateUserDTO) {
+    this.logger.info({ userId: data.id, label: 'UserService' }, 'Creating user');
+    // ... implementation
+  }
+}
 ```
 
-### Linting
+## 🛠️ Development
 
-Check code style and catch errors using Biome:
+### Setup
 
 ```bash
-pnpm lint
-pnpm lint:fix
-```
+# Install dependencies
+pnpm install
 
-### Building
+# Build the library
+pnpm run build
 
-Compile TypeScript into the `dist/` folder:
+# Run type checking
+pnpm run typecheck
 
-```bash
-pnpm build
+# Run linting
+pnpm run lint
+
+# Format code
+pnpm run format
 ```
 
-Check types without generating output:
+### Project Structure
 
-```bash
-pnpm typecheck
 ```
+togather-shared-utils/
+├── src/
+│   ├── logger/              # Logger module
+│   │   ├── ILogger.ts       # Logger interface
+│   │   ├── PinoLogger.ts    # Pino implementation
+│   │   ├── index.ts         # Module exports
+│   │   └── README.md        # Logger documentation
+│   └── index.ts             # Main library exports
+├── dist/                    # Compiled output (generated)
+├── scripts/                 # Publishing scripts
+│   ├── publish.js           # NPM publishing script
+│   └── version.js           # Version bumping script
+├── package.json
+├── tsconfig.json
+├── biome.json
+└── README.md
+```
+
+## 📤 Publishing
 
-### Publishing Package
+### Version Bumping
 
-To publish the package to npm:
+```bash
+# Bump patch version (1.0.0 -> 1.0.1) for bug fixes
+pnpm run version:patch
+
+# Bump minor version (1.0.0 -> 1.1.0) for new features
+pnpm run version:minor
+
+# Bump major version (1.0.0 -> 2.0.0) for breaking changes
+pnpm run version:major
+```
+
+### Publishing to NPM
 
 ```bash
-pnpm run release
+# Dry run (test publishing without actually publishing)
+pnpm run publish:npm -- --dry-run
+
+# Publish to npm with 'latest' tag
+pnpm run publish:npm
+
+# Publish with a specific tag (e.g., beta)
+pnpm run publish:npm -- --tag beta
 ```
 
-This script performs:
+The publish script automatically:
+- ✅ Checks git status
+- ✅ Runs type checking
+- ✅ Runs linting
+- ✅ Builds the package
+- ✅ Checks if version already exists
+- ✅ Publishes to npm
+- ✅ Creates and pushes git tag
 
-* Builds the package
-* Commits changes
-* Updates version (patch/minor/major)
-* Publishes to npm with public access
+## 🔄 Workflow
 
-Ensure all changes are committed and tests pass before publishing.
+### Adding a New Feature
 
-## Using the Utilities
+1. Create a new branch
+   ```bash
+   git checkout -b feat/new-utility
+   ```
 
-### TypeScript
+2. Make your changes and commit
+   ```bash
+   git add .
+   pnpm run commit  # Uses commitizen for conventional commits
+   ```
 
-Install the package:
+3. Bump version
+   ```bash
+   pnpm run version:minor  # or patch/major
+   ```
 
-```bash
-pnpm add @togatherlabs/shared-utils
-```
+4. Push changes
+   ```bash
+   git push origin feat/new-utility
+   git push --tags
+   ```
+
+5. Publish to npm
+   ```bash
+   pnpm run publish:npm
+   ```
 
-Example usage:
+## 📋 Commit Convention
 
-```ts
-import { formatDate, generateId, logger } from '@togatherlabs/shared-utils';
+This project uses [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+<type>(<scope>): <subject>
 
-// Format a date
-console.log(formatDate(new Date()));
+<body>
+```
 
-// Generate a unique ID
-const id = generateId();
-console.log(id);
+**Types:**
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation changes
+- `style`: Code style changes (formatting)
+- `refactor`: Code refactoring
+- `test`: Adding or updating tests
+- `chore`: Maintenance tasks
 
-// Log messages
-logger.info('Service started');
-logger.error('Failed to fetch data', { error: new Error('Network error') });
+**Example:**
 ```
+feat(logger): Add support for custom log formatters
 
-## Best Practices
+Added a new option to PinoLogger constructor that allows users to
+provide custom formatters for log messages. This enables better
+integration with external logging services.
+```
 
-* Keep utilities small and focused – each function should have a single responsibility.
-* Type safety – use TypeScript types/interfaces, avoid `any`.
-* Documentation – add JSDoc comments for each utility.
-* Testing – write unit tests for every new utility.
-* Consistent exports – always export utilities through `index.ts` files.
+Use `pnpm run commit` for an interactive commit prompt.
 
-## Troubleshooting
+## 🧪 Testing
 
-**Cannot find module '@togatherlabs/shared-utils'**
+```bash
+# Run tests (when available)
+pnpm test
 
-* Ensure the package is installed
-* Check `tsconfig.json` paths if using path aliases
-* Delete `node_modules` and reinstall dependencies
+# Run tests with coverage
+pnpm test:coverage
+```
 
-**Property 'myFunction' does not exist**
+## 📖 Documentation
 
-* Ensure the function is exported correctly
-* Verify the import path matches the package export
+- [Logger Documentation](./src/logger/README.md)
 
-**Build errors**
+## 🤝 Contributing
 
-* Check for missing peer dependencies
-* Ensure relative imports are correct
-* Clean and rebuild the project
+1. Follow the commit convention
+2. Write tests for new features
+3. Update documentation
+4. Ensure all checks pass before publishing
 
-**Version mismatches across services**
+## 📄 License
 
-* Make sure all services use compatible versions of shared-utils
-* Check changelog for breaking changes
+Internal use only - Togather Infrastructure
 
-**TypeScript declaration errors**
+## 🆘 Support
 
-* Ensure `declaration: true` is set in `tsconfig.json`
-* Verify the `types` field in `package.json` points to the correct declaration file
-* Run `pnpm build` to regenerate type definitions
+For questions or issues, contact the platform team.
 
-## License
+## 🔗 Related Packages
 
-MIT © ToGather Labs
+- [@togatherlabs/shared-protos](../togather-shared-protos) - Shared Protocol Buffers
+- [@togatherlabs/event-sdk](../togather-shared-events) - Event handling SDK

package/dist/index.d.ts

@@ -1,4 +1,2 @@
-export * from "./constants/index.js";
-export * from "./helpers/index.js";
-export * from "./types/index.js";
+export * from './logger/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export * from "./constants/index.js";
-export * from "./helpers/index.js";
-export * from "./types/index.js";
+// Main library exports
+export * from './logger/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,cAAc,mBAAmB,CAAC"}

package/dist/logger/ILogger.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Logger interface for structured logging.
+ * Supports all standard log levels and child logger creation for contextual logging.
+ */
+export interface ILogger {
+    /**
+     * Log informational messages
+     *
+     * @param labels - Context object that can include:
+     *   - `label`: string | string[] - Categorization labels (e.g., class name, method name, operation type)
+     *   - Any other contextual data (userId, requestId, etc.)
+     * @param msg - Human-readable log message (supports string interpolation with args)
+     * @param args - Values for string interpolation in the message (e.g., logger.info({}, 'User %s logged in', userId))
+     *
+     * @example
+     * logger.info({ label: 'UserService' }, 'User created');
+     * logger.info({ label: ['UserService', 'createUser'] }, 'Creating user');
+     * logger.info({ userId: '123', label: 'UserService.createUser' }, 'User created successfully');
+     * logger.info({ label: 'UserService' }, 'User %s created with email %s', userId, email);
+     */
+    info(labels: object | string, msg?: string, ...args: unknown[]): void;
+    /**
+     * Log warning messages
+     *
+     * @param labels - Context object that can include:
+     *   - `label`: string | string[] - Categorization labels (e.g., class name, method name, operation type)
+     *   - Any other contextual data (userId, requestId, etc.)
+     * @param msg - Human-readable log message (supports string interpolation with args)
+     * @param args - Values for string interpolation in the message
+     *
+     * @example
+     * logger.warn({ label: 'RateLimiter' }, 'Rate limit approaching');
+     * logger.warn({ userId: '123', label: ['AuthService', 'login'] }, 'Multiple failed attempts');
+     * logger.warn({ label: 'RateLimiter' }, 'User %s exceeded %d requests', userId, maxRequests);
+     */
+    warn(labels: object | string, msg?: string, ...args: unknown[]): void;
+    /**
+     * Log error messages
+     *
+     * @param labels - Context object that can include:
+     *   - `label`: string | string[] - Categorization labels (e.g., class name, method name, operation type)
+     *   - `err`: Error - The error object for proper serialization
+     *   - Any other contextual data (userId, requestId, etc.)
+     * @param msg - Human-readable log message (supports string interpolation with args)
+     * @param args - Values for string interpolation in the message
+     *
+     * @example
+     * logger.error({ err, label: 'DatabaseService' }, 'Connection failed');
+     * logger.error({ err, userId: '123', label: ['UserRepository', 'findById'] }, 'Query failed');
+     * logger.error({ err, label: 'DatabaseService' }, 'Failed to connect to %s on port %d', host, port);
+     */
+    error(labels: object | string, msg?: string, ...args: unknown[]): void;
+    /**
+     * Log debug messages
+     *
+     * @param labels - Context object that can include:
+     *   - `label`: string | string[] - Categorization labels (e.g., class name, method name, operation type)
+     *   - Any other contextual data (userId, requestId, etc.)
+     * @param msg - Human-readable log message (supports string interpolation with args)
+     * @param args - Values for string interpolation in the message
+     *
+     * @example
+     * logger.debug({ label: 'CacheService' }, 'Cache hit');
+     * logger.debug({ cacheKey: 'user:123', label: ['CacheService', 'get'] }, 'Retrieved from cache');
+     * logger.debug({ label: 'CacheService' }, 'Cache hit for key %s in %dms', cacheKey, duration);
+     */
+    debug(labels: object | string, msg?: string, ...args: unknown[]): void;
+    /**
+     * Log fatal messages (highest severity)
+     *
+     * @param labels - Context object that can include:
+     *   - `label`: string | string[] - Categorization labels (e.g., class name, method name, operation type)
+     *   - `err`: Error - The error object for proper serialization
+     *   - Any other contextual data (userId, requestId, etc.)
+     * @param msg - Human-readable log message (supports string interpolation with args)
+     * @param args - Values for string interpolation in the message
+     *
+     * @example
+     * logger.fatal({ err, label: 'Application' }, 'Critical system failure');
+     * logger.fatal({ err, label: 'Application' }, 'System crashed after %d retries', retryCount);
+     */
+    fatal(labels: object | string, msg?: string, ...args: unknown[]): void;
+    /**
+     * Log trace messages (lowest severity)
+     *
+     * @param labels - Context object that can include:
+     *   - `label`: string | string[] - Categorization labels (e.g., class name, method name, operation type)
+     *   - Any other contextual data (userId, requestId, etc.)
+     * @param msg - Human-readable log message (supports string interpolation with args)
+     * @param args - Values for string interpolation in the message
+     *
+     * @example
+     * logger.trace({ label: ['UserService', 'createUser', 'validation'] }, 'Validating input');
+     * logger.trace({ label: 'UserService' }, 'Step %d: %s', stepNumber, stepName);
+     */
+    trace(labels: object | string, msg?: string, ...args: unknown[]): void;
+}
+//# sourceMappingURL=ILogger.d.ts.map

package/dist/logger/ILogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.d.ts","sourceRoot":"","sources":["../../src/logger/ILogger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,OAAO;IACvB;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEtE;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEtE;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEvE;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEvE;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEvE;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACvE"}

package/dist/logger/ILogger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ILogger.js.map

package/dist/logger/ILogger.js.map

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

package/dist/logger/PinoLogger.d.ts

@@ -0,0 +1,31 @@
+import { type LoggerOptions } from 'pino';
+import type { ILogger } from './ILogger.js';
+/**
+ * Pino logger implementation with configurable options.
+ *
+ * @example
+ * const logger = new PinoLogger();
+ *
+ * @example
+ * const logger = new PinoLogger({
+ *   level: 'debug',
+ *   base: { service: 'my-service', version: '1.0.0' }
+ * });
+ */
+export declare class PinoLogger implements ILogger {
+    private logger;
+    /**
+     * Creates a new PinoLogger instance.
+     *
+     * @param options - Pino logger options. If not provided, uses environment-aware defaults.
+     *                  Any options passed will be merged with defaults, with passed options taking precedence.
+     */
+    constructor(options?: LoggerOptions);
+    info(labels: object | string, msg?: string, ...args: unknown[]): void;
+    warn(labels: object | string, msg?: string, ...args: unknown[]): void;
+    error(labels: object | string, msg?: string, ...args: unknown[]): void;
+    debug(labels: object | string, msg?: string, ...args: unknown[]): void;
+    fatal(labels: object | string, msg?: string, ...args: unknown[]): void;
+    trace(labels: object | string, msg?: string, ...args: unknown[]): void;
+}
+//# sourceMappingURL=PinoLogger.d.ts.map

package/dist/logger/PinoLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PinoLogger.d.ts","sourceRoot":"","sources":["../../src/logger/PinoLogger.ts"],"names":[],"mappings":"AAAA,OAAa,EAAqC,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAEnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C;;;;;;;;;;;GAWG;AACH,qBACa,UAAW,YAAW,OAAO;IACzC,OAAO,CAAC,MAAM,CAAqB;IAEnC;;;;;OAKG;gBACS,OAAO,CAAC,EAAE,aAAa;IA8EnC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIrE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIrE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAItE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAItE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAItE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGtE"}

package/dist/logger/PinoLogger.js

@@ -0,0 +1,128 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import pino from 'pino';
+import { injectable } from 'inversify';
+import { hostname } from 'node:os';
+/**
+ * Pino logger implementation with configurable options.
+ *
+ * @example
+ * const logger = new PinoLogger();
+ *
+ * @example
+ * const logger = new PinoLogger({
+ *   level: 'debug',
+ *   base: { service: 'my-service', version: '1.0.0' }
+ * });
+ */
+let PinoLogger = class PinoLogger {
+    logger;
+    /**
+     * Creates a new PinoLogger instance.
+     *
+     * @param options - Pino logger options. If not provided, uses environment-aware defaults.
+     *                  Any options passed will be merged with defaults, with passed options taking precedence.
+     */
+    constructor(options) {
+        const nodeEnv = process.env.NODE_ENV || 'development';
+        const isDevelopment = nodeEnv === 'development';
+        const isProduction = nodeEnv === 'production';
+        const defaultOptions = {
+            level: process.env.LOG_LEVEL || 'info',
+            base: {
+                pid: process.pid,
+                hostname: process.env.HOSTNAME || hostname(),
+                service: process.env.SERVICE_NAME,
+                environment: nodeEnv,
+            },
+            timestamp: isDevelopment ? pino.stdTimeFunctions.isoTime : pino.stdTimeFunctions.isoTime,
+            // Error serialization for proper error logging
+            serializers: {
+                err: pino.stdSerializers.err,
+                error: pino.stdSerializers.err,
+                req: pino.stdSerializers.req,
+                res: pino.stdSerializers.res,
+            },
+            // Redact sensitive information in production
+            redact: {
+                paths: [
+                    'password',
+                    '*.password',
+                    'token',
+                    '*.token',
+                    'accessToken',
+                    '*.accessToken',
+                    'refreshToken',
+                    '*.refreshToken',
+                    'secret',
+                    '*.secret',
+                    'authorization',
+                    '*.authorization',
+                    'cookie',
+                    '*.cookie',
+                    'apiKey',
+                    '*.apiKey',
+                ],
+                remove: isProduction, // Remove in production, mask in development
+            },
+            // Pretty printing for development
+            transport: isDevelopment
+                ? {
+                    target: 'pino-pretty',
+                    options: {
+                        colorize: true,
+                        translateTime: 'HH:MM:ss Z',
+                        ignore: 'pid,hostname',
+                        singleLine: false,
+                        messageFormat: '{levelLabel} - {msg}',
+                    },
+                }
+                : undefined,
+        };
+        const mergedOptions = {
+            ...defaultOptions,
+            ...options,
+            base: {
+                ...defaultOptions.base,
+                ...(options?.base || {}),
+            },
+            serializers: {
+                ...defaultOptions.serializers,
+                ...(options?.serializers || {}),
+            },
+            redact: options?.redact !== undefined ? options.redact : defaultOptions.redact,
+        };
+        this.logger = pino(mergedOptions);
+    }
+    info(labels, msg, ...args) {
+        this.logger.info(labels, msg, ...args);
+    }
+    warn(labels, msg, ...args) {
+        this.logger.warn(labels, msg, ...args);
+    }
+    error(labels, msg, ...args) {
+        this.logger.error(labels, msg, ...args);
+    }
+    debug(labels, msg, ...args) {
+        this.logger.debug(labels, msg, ...args);
+    }
+    fatal(labels, msg, ...args) {
+        this.logger.fatal(labels, msg, ...args);
+    }
+    trace(labels, msg, ...args) {
+        this.logger.trace(labels, msg, ...args);
+    }
+};
+PinoLogger = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [Object])
+], PinoLogger);
+export { PinoLogger };
+//# sourceMappingURL=PinoLogger.js.map

package/dist/logger/PinoLogger.js.map

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

package/dist/logger/index.d.ts

@@ -0,0 +1,3 @@
+export { ILogger } from './ILogger.js';
+export { PinoLogger } from './PinoLogger.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/logger/index.js

@@ -0,0 +1,2 @@
+export { PinoLogger } from './PinoLogger.js';
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,88 +1,78 @@
 {
-  "name": "@togatherlabs/shared-utils",
-  "version": "1.0.10",
-  "description": "Shared utility functions, constants, and types for ToGather microservices",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./helpers": {
-      "import": "./dist/helpers/index.js",
-      "require": "./dist/helpers/index.js",
-      "types": "./dist/helpers/index.d.ts"
-    },
-    "./constants": {
-      "import": "./dist/constants/index.js",
-      "require": "./dist/constants/index.js",
-      "types": "./dist/constants/index.d.ts"
-    },
-    "./types": {
-      "import": "./dist/types/index.js",
-      "require": "./dist/types/index.js",
-      "types": "./dist/types/index.d.ts"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "keywords": [
-    "shared",
-    "utils",
-    "togather",
-    "microservices"
-  ],
-  "author": "toGather team",
-  "license": "ISC",
-  "devDependencies": {
-    "@biomejs/biome": "^2.2.6",
-    "@commitlint/cli": "^20.1.0",
-    "@commitlint/config-conventional": "^20.0.0",
-    "@commitlint/cz-commitlint": "^20.1.0",
-    "@commitlint/types": "^20.0.0",
-    "@tsconfig/node22": "^22.0.2",
-    "@types/node": "^24.7.2",
-    "@vitest/coverage-v8": "^3.2.4",
-    "@vitest/ui": "^3.2.4",
-    "commitizen": "^4.3.1",
-    "husky": "^9.1.7",
-    "inquirer": "^9.3.8",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
-  },
-  "config": {
-    "commitizen": {
-      "path": "@commitlint/cz-commitlint"
-    }
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "lint": "biome lint .",
-    "lint:fix": "biome lint --write .",
-    "format": "biome format .",
-    "format:fix": "biome format --write .",
-    "check": "biome check .",
-    "check:fix": "biome check --write .",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:ui": "vitest --ui",
-    "commit": "git-cz",
-    "package:patch": "pnpm version patch",
-    "package:minor": "pnpm version minor",
-    "package:major": "pnpm version major",
-    "package:publish": "pnpm publish --access public",
-    "release:patch": "pnpm build && git add . && pnpm commit && pnpm package:patch && git push --follow-tags && pnpm package:publish",
-    "release:minor": "pnpm build && git add . && pnpm commit && pnpm package:minor && git push --follow-tags && pnpm package:publish",
-    "release:major": "pnpm build && git add . && pnpm commit && pnpm package:major && git push --follow-tags && pnpm package:publish"
-  }
-}
+	"name": "@togatherlabs/shared-utils",
+	"version": "1.1.0",
+	"description": "Shared utilities for Togather services including logger, validators, and common helpers",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"type": "module",
+	"scripts": {
+		"prepare": "husky",
+		"build": "tsc",
+		"typecheck": "tsc --noEmit",
+		"lint": "biome check .",
+		"lint:fix": "biome check . --write",
+		"format": "biome format . --write",
+		"clean": "rm -rf dist",
+		"prebuild": "pnpm run clean",
+		"prepublishOnly": "pnpm run build",
+		"commit": "cz",
+		"publish:npm": "./scripts/publish.sh",
+		"version:patch": "./scripts/version.sh patch",
+		"version:minor": "./scripts/version.sh minor",
+		"version:major": "./scripts/version.sh major"
+	},
+	"keywords": [
+		"togather",
+		"utilities",
+		"logger",
+		"pino",
+		"shared"
+	],
+	"author": "Togather Team",
+	"license": "ISC",
+	"packageManager": "pnpm@10.7.1",
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		},
+		"./logger": {
+			"import": "./dist/logger/index.js",
+			"types": "./dist/logger/index.d.ts"
+		}
+	},
+	"dependencies": {
+		"inversify": "^7.10.4",
+		"pino": "^10.1.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.2.5",
+		"@commitlint/cli": "^20.1.0",
+		"@commitlint/config-conventional": "^20.0.0",
+		"@commitlint/cz-commitlint": "^20.1.0",
+		"@commitlint/types": "^20.0.0",
+		"@types/node": "^24.9.1",
+		"commitizen": "^4.3.1",
+		"husky": "^9.1.7",
+		"pino-pretty": "^13.1.2",
+		"typescript": "^5.9.3"
+	},
+	"peerDependencies": {
+		"pino-pretty": "^13.1.2"
+	},
+	"peerDependenciesMeta": {
+		"pino-pretty": {
+			"optional": true
+		}
+	},
+	"config": {
+		"commitizen": {
+			"path": "@commitlint/cz-commitlint"
+		}
+	}
+}

package/dist/constants/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./sample.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/constants/index.js

@@ -1 +0,0 @@
-export * from "./sample.js";

package/dist/constants/sample.d.ts

@@ -1,4 +0,0 @@
-export declare const SAMPLE: {
-    Char: string;
-};
-//# sourceMappingURL=sample.d.ts.map

package/dist/constants/sample.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../src/constants/sample.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;CAElB,CAAC"}

package/dist/constants/sample.js

@@ -1,3 +0,0 @@
-export const SAMPLE = {
-    Char: "A",
-};

package/dist/helpers/formatDate.d.ts

@@ -1,2 +0,0 @@
-export declare function formatDate(date: Date, locale?: string): string;
-//# sourceMappingURL=formatDate.d.ts.map

package/dist/helpers/formatDate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatDate.d.ts","sourceRoot":"","sources":["../../src/helpers/formatDate.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,SAAU,GAAG,MAAM,CAU/D"}

package/dist/helpers/formatDate.js

@@ -1,10 +0,0 @@
-export function formatDate(date, locale = "en-IN") {
-    if (!(date instanceof Date) || Number.isNaN(date.getTime())) {
-        throw new Error("Invalid Date");
-    }
-    return date.toLocaleDateString(locale, {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-    });
-}

package/dist/helpers/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./formatDate.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/helpers/index.js

@@ -1 +0,0 @@
-export * from "./formatDate.js";

package/dist/types/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./user.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/types/index.js

@@ -1 +0,0 @@
-export * from "./user.js";

package/dist/types/user.d.ts

@@ -1,6 +0,0 @@
-export interface UserDTO {
-    id: string;
-    name: string;
-    email: string;
-}
-//# sourceMappingURL=user.d.ts.map

package/dist/types/user.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/types/user.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/user.js

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