@togatherlabs/shared-utils 1.0.10 → 1.2.0

package/README.md

@@ -1,175 +1,271 @@
 # @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 { Logger, ILogger } from '@togatherlabs/shared-utils/logger';
 
-```
-src/
-├── constants/
-│   └── index.ts
-├── utils/
-│   └── index.ts
-├── types/
-│   └── index.ts
-└── index.ts
+// Minimal - uses defaults
+const logger = new Logger();
+
+// With environment config from service (recommended)
+const logger = new Logger(undefined, {
+  nodeEnv: process.env.NODE_ENV,
+  logLevel: process.env.LOG_LEVEL,
+  serviceName: process.env.SERVICE_NAME
+});
+
+logger.info({ label: 'app' }, 'Application started');
+logger.error({ err, label: 'database' }, 'Connection failed');
 ```
 
-* **constants**: Shared constants across services
-* **utils**: Reusable utility functions
-* **types**: Shared TypeScript types and interfaces
-* **index.ts**: Exports all public utilities
+**Full documentation**: [Logger README](./src/logger/README.md)
 
-## Package Development
+## 🔧 Usage
 
-### Adding New Utilities
+### Basic Import
 
-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.
+```typescript
+// Import from main entry point
+import { Logger, ILogger, type LoggerConfig } from '@togatherlabs/shared-utils';
 
-**Example:** Adding a new utility `capitalize`:
+// Or import from specific module
+import { Logger, ILogger, type LoggerConfig } from '@togatherlabs/shared-utils/logger';
+```
 
-```ts
-// src/utils/capitalize.ts
-export function capitalize(str: string): string {
-  return str.charAt(0).toUpperCase() + str.slice(1);
-}
+### Configuration
+
+**Services pass environment variables via LoggerConfig:**
+
+```typescript
+import { Logger, type LoggerConfig } from '@togatherlabs/shared-utils/logger';
 
-// src/utils/index.ts
-export * from './capitalize';
+const config: LoggerConfig = {
+  nodeEnv: process.env.NODE_ENV,
+  logLevel: process.env.LOG_LEVEL,
+  serviceName: process.env.SERVICE_NAME
+};
 
-// src/index.ts
-export * from './utils';
+const logger = new Logger(undefined, config);
 ```
 
-### Linting
+**LoggerConfig fields:**
+- `nodeEnv` - Environment: `'development'` (pretty logs) or `'production'` (JSON logs)
+- `logLevel` - Log level (default: `'info'`)
+- `serviceName` - Service name for context
+- `hostname` - Hostname override (optional)
 
-Check code style and catch errors using Biome:
+See the [Logger README](./src/logger/README.md) for detailed configuration options.
 
-```bash
-pnpm lint
-pnpm lint:fix
+### With Dependency Injection
+
+```typescript
+import { injectable, inject } from 'inversify';
+import type { ILogger } from '@togatherlabs/shared-utils/logger';
+
+@injectable()
+class UserService {
+  constructor(
+    @inject(TYPES.Logger) private logger: ILogger
+  ) {}
+
+  async createUser(data: CreateUserDTO) {
+    this.logger.info({ userId: data.id, label: 'UserService' }, 'Creating user');
+    // ... implementation
+  }
+}
 ```
 
-### Building
+## 🛠️ Development
 
-Compile TypeScript into the `dist/` folder:
+### Setup
 
 ```bash
-pnpm build
+# Install dependencies
+pnpm install
+
+# Build the library
+pnpm run build
+
+# Run type checking
+pnpm run typecheck
+
+# 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
+│   │   ├── logger.ts        # Logger 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 Package
+## 📤 Publishing
 
-To publish the package to npm:
+### Version Bumping
 
 ```bash
-pnpm run release
+# 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
 ```
 
-This script performs:
+### Publishing to NPM
+
+```bash
+# Dry run (test publishing without actually publishing)
+pnpm run publish:npm -- --dry-run
+
+# Publish to npm with 'latest' tag
+pnpm run publish:npm
 
-* Builds the package
-* Commits changes
-* Updates version (patch/minor/major)
-* Publishes to npm with public access
+# Publish with a specific tag (e.g., beta)
+pnpm run publish:npm -- --tag beta
+```
 
-Ensure all changes are committed and tests pass before publishing.
+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
 
-## Using the Utilities
+## 🔄 Workflow
 
-### TypeScript
+### Adding a New Feature
 
-Install the package:
+1. Create a new branch
+   ```bash
+   git checkout -b feat/new-utility
+   ```
 
-```bash
-pnpm add @togatherlabs/shared-utils
-```
+2. Make your changes and commit
+   ```bash
+   git add .
+   pnpm run commit  # Uses commitizen for conventional commits
+   ```
 
-Example usage:
+3. Bump version
+   ```bash
+   pnpm run version:minor  # or patch/major
+   ```
 
-```ts
-import { formatDate, generateId, logger } from '@togatherlabs/shared-utils';
+4. Push changes
+   ```bash
+   git push origin feat/new-utility
+   git push --tags
+   ```
 
-// Format a date
-console.log(formatDate(new Date()));
+5. Publish to npm
+   ```bash
+   pnpm run publish:npm
+   ```
 
-// Generate a unique ID
-const id = generateId();
-console.log(id);
+## 📋 Commit Convention
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/):
 
-// Log messages
-logger.info('Service started');
-logger.error('Failed to fetch data', { error: new Error('Network error') });
 ```
+<type>(<scope>): <subject>
 
-## Best Practices
+<body>
+```
 
-* 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.
+**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
 
-## Troubleshooting
+**Example:**
+```
+feat(logger): Add support for custom log formatters
+
+Added a new option to Logger constructor that allows users to
+provide custom formatters for log messages. This enables better
+integration with external logging services.
+```
 
-**Cannot find module '@togatherlabs/shared-utils'**
+Use `pnpm run commit` for an interactive commit prompt.
 
-* Ensure the package is installed
-* Check `tsconfig.json` paths if using path aliases
-* Delete `node_modules` and reinstall dependencies
+## 🧪 Testing
+
+```bash
+# Run tests (when available)
+pnpm test
+
+# 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,97 @@
+/**
+ * Logger interface for structured 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;;GAEG;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/index.d.ts

@@ -0,0 +1,3 @@
+export { ILogger } from './ILogger.js';
+export { Logger, type LoggerConfig } from './logger.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,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/logger/index.js

@@ -0,0 +1,2 @@
+export { Logger } from './logger.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,MAAM,EAAqB,MAAM,aAAa,CAAC"}

package/dist/logger/logger.d.ts

@@ -0,0 +1,51 @@
+import { type LoggerOptions } from 'pino';
+import type { ILogger } from './ILogger.js';
+export interface LoggerConfig {
+    /** Node environment (e.g., 'development', 'production', 'test') */
+    nodeEnv?: string;
+    /** Log level (e.g., 'info', 'debug', 'warn', 'error') */
+    logLevel?: string;
+    /** Service name for log context */
+    serviceName?: string;
+    /** Hostname override */
+    hostname?: string;
+}
+/**
+ * Pino logger implementation with configurable options.
+ *
+ * @example
+ * // Minimal - uses defaults
+ * const logger = new Logger();
+ *
+ * @example
+ * // With environment config from service
+ * const logger = new Logger(undefined, {
+ *   nodeEnv: process.env.NODE_ENV,
+ *   logLevel: process.env.LOG_LEVEL,
+ *   serviceName: process.env.SERVICE_NAME
+ * });
+ *
+ * @example
+ * // With custom Pino options
+ * const logger = new Logger({
+ *   level: 'debug',
+ *   base: { service: 'my-service', version: '1.0.0' }
+ * });
+ */
+export declare class Logger implements ILogger {
+    private logger;
+    /**
+     * Creates a new Logger instance.
+     *
+     * @param options - logger options for advanced configuration
+     * @param config - Environment configuration passed from the service
+     */
+    constructor(options?: LoggerOptions, config?: LoggerConfig);
+    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=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAa,EAAqC,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAEnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,WAAW,YAAY;IAC5B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBACa,MAAO,YAAW,OAAO;IACrC,OAAO,CAAC,MAAM,CAAqB;IAEnC;;;;;OAKG;gBACS,OAAO,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,YAAY;IA8E1D,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/logger.js

@@ -0,0 +1,138 @@
+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
+ * // Minimal - uses defaults
+ * const logger = new Logger();
+ *
+ * @example
+ * // With environment config from service
+ * const logger = new Logger(undefined, {
+ *   nodeEnv: process.env.NODE_ENV,
+ *   logLevel: process.env.LOG_LEVEL,
+ *   serviceName: process.env.SERVICE_NAME
+ * });
+ *
+ * @example
+ * // With custom Pino options
+ * const logger = new Logger({
+ *   level: 'debug',
+ *   base: { service: 'my-service', version: '1.0.0' }
+ * });
+ */
+let Logger = class Logger {
+    logger;
+    /**
+     * Creates a new Logger instance.
+     *
+     * @param options - logger options for advanced configuration
+     * @param config - Environment configuration passed from the service
+     */
+    constructor(options, config) {
+        const nodeEnv = config?.nodeEnv || 'development';
+        const isDevelopment = nodeEnv === 'development';
+        const isProduction = nodeEnv === 'production';
+        const defaultOptions = {
+            level: config?.logLevel || 'info',
+            base: {
+                pid: process.pid,
+                hostname: config?.hostname || hostname(),
+                service: config?.serviceName,
+                environment: nodeEnv,
+            },
+            timestamp: 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);
+    }
+};
+Logger = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [Object, Object])
+], Logger);
+export { Logger };
+//# sourceMappingURL=logger.js.map

package/dist/logger/logger.js.map

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

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.2.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 {};