@arivlabs/logger 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to `@arivlabs/logger` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2024-12-23
+
+### Added
+
+- Initial release
+- `createLogger()` function for creating structured loggers
+- Domain-specific logging with `logger.domain()`
+- Request context logging with `logger.withContext()`
+- CloudWatch-friendly JSON output
+- Pretty printing for development
+- TypeScript support with full type definitions
+- Support for custom service names and log levels

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ArivLabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @arivlabs/logger
+
+Structured logging for ArivLabs services with CloudWatch support.
+
+## Installation
+
+```bash
+pnpm add @arivlabs/logger
+
+# Optional: for pretty printing in development
+pnpm add -D pino-pretty
+```
+
+## Usage
+
+```typescript
+import { createLogger } from '@arivlabs/logger';
+
+// Create a logger for your service
+const logger = createLogger({ service: 'api-gateway' });
+
+// Basic logging
+logger.info({ msg: 'Server started', port: 3000 });
+logger.error({ msg: 'Something failed', error: err.message });
+
+// Domain-specific logging
+const discoveryLog = logger.domain('discovery');
+discoveryLog.info({ msg: 'Job created', jobId: '123' });
+
+// Request context logging
+const reqLog = logger.withContext({
+  correlationId: 'abc-123',
+  tenantId: 'tenant-1',
+  domain: 'discovery',
+});
+reqLog.info({ msg: 'Processing request' });
+```
+
+## CloudWatch Insights Queries
+
+```sql
+-- Filter by service
+fields @timestamp, @message
+| filter service = "api-gateway"
+
+-- Filter by domain
+fields @timestamp, @message
+| filter domain = "discovery"
+
+-- Filter errors
+fields @timestamp, @message
+| filter level = "error"
+
+-- Filter by tenant
+fields @timestamp, @message
+| filter tenant_id = "xxx"
+
+-- Combine filters
+fields @timestamp, service, domain, @message
+| filter service = "api-gateway" and domain = "discovery"
+| sort @timestamp desc
+| limit 100
+```
+
+## Configuration
+
+```typescript
+const logger = createLogger({
+  service: 'api-gateway', // Required: service name
+  environment: 'production', // Optional: defaults to NODE_ENV
+  level: 'info', // Optional: debug, info, warn, error
+  pretty: false, // Optional: defaults to true in development
+});
+```
+
+## Log Format
+
+JSON output (production):
+
+```json
+{
+  "level": 30,
+  "timestamp": "2024-01-15T10:30:00.000Z",
+  "service": "api-gateway",
+  "environment": "production",
+  "domain": "discovery",
+  "correlation_id": "abc-123",
+  "tenant_id": "tenant-1",
+  "msg": "Job created",
+  "jobId": "job-456"
+}
+```
+
+Pretty output (development):
+
+```
+10:30:00 Z [api-gateway:discovery] abc-123 Job created
+```
+
+## Available Domains
+
+- `discovery` - Discovery scanning
+- `auth` - Authentication
+- `connectors` - Cloud connectors
+- `inventory` - Resource inventory
+- `lineage` - Data lineage
+- `onboarding` - Customer onboarding
+- `proxy` - AI proxy
+- `users` - User management
+- `dashboard` - Analytics dashboard
+- `internal` - Internal APIs
+- `storage` - File storage
+- `email` - Email service
+- `queue` - Queue processing
+- `system` - System-level logs

package/dist/__mocks__/pino.d.ts

@@ -0,0 +1,9 @@
+declare const pino: jest.Mock & {
+    stdSerializers: {
+        req: jest.Mock;
+        res: jest.Mock;
+        err: jest.Mock;
+    };
+};
+export default pino;
+//# sourceMappingURL=pino.d.ts.map

package/dist/__mocks__/pino.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino.d.ts","sourceRoot":"","sources":["../../src/__mocks__/pino.ts"],"names":[],"mappings":"AAYA,QAAA,MAAM,IAAI,EAAgC,IAAI,CAAC,IAAI,GAAG;IACpD,cAAc,EAAE;QACd,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;QACf,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;QACf,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;KAChB,CAAC;CACH,CAAC;AAQF,eAAe,IAAI,CAAC"}

package/dist/__mocks__/pino.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mockChild = jest.fn().mockReturnThis();
+const mockLogger = {
+    info: jest.fn(),
+    warn: jest.fn(),
+    error: jest.fn(),
+    debug: jest.fn(),
+    fatal: jest.fn(),
+    trace: jest.fn(),
+    child: mockChild,
+};
+const pino = jest.fn(() => mockLogger);
+pino.stdSerializers = {
+    req: jest.fn(),
+    res: jest.fn(),
+    err: jest.fn(),
+};
+exports.default = pino;
+//# sourceMappingURL=pino.js.map

package/dist/__mocks__/pino.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino.js","sourceRoot":"","sources":["../../src/__mocks__/pino.ts"],"names":[],"mappings":";;AAAA,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,cAAc,EAAE,CAAC;AAE7C,MAAM,UAAU,GAAG;IACjB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;IACf,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;IACf,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;IAChB,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;IAChB,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;IAChB,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;IAChB,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,UAAU,CAMpC,CAAC;AAEF,IAAI,CAAC,cAAc,GAAG;IACpB,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;IACd,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;IACd,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;CACf,CAAC;AAEF,kBAAe,IAAI,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+import type { Logger as PinoLogger } from 'pino';
+/**
+ * Service names for ArivLabs services
+ */
+export type ServiceName = 'api-gateway' | 'queue-manager' | 'scanner-result-processor' | 'enrichment-processor' | 'lineage-processor' | 'ai-proxy' | 'control-plane';
+/**
+ * Domain names for structured logging
+ */
+export type LogDomain = 'discovery' | 'auth' | 'connectors' | 'inventory' | 'lineage' | 'onboarding' | 'proxy' | 'users' | 'dashboard' | 'internal' | 'storage' | 'email' | 'queue' | 'system';
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /** Service name (e.g., 'api-gateway') */
+    service: ServiceName | string;
+    /** Environment (defaults to NODE_ENV or 'development') */
+    environment?: string;
+    /** Log level (defaults to 'debug' in dev, 'info' in prod) */
+    level?: string;
+    /** Enable pretty printing (defaults to true in development) */
+    pretty?: boolean;
+}
+/**
+ * Extended logger interface with domain support
+ */
+export interface ArivLogger extends PinoLogger {
+    /** Create a child logger for a specific domain */
+    domain: (domain: LogDomain) => PinoLogger;
+    /** Create a child logger with request context */
+    withContext: (context: RequestContext) => PinoLogger;
+}
+/**
+ * Request context for correlation
+ */
+export interface RequestContext {
+    correlationId: string;
+    userId?: string;
+    tenantId?: string;
+    domain?: LogDomain;
+}
+/**
+ * Create a structured logger for an ArivLabs service
+ *
+ * @example
+ * ```typescript
+ * import { createLogger } from '@arivlabs/logger';
+ *
+ * const logger = createLogger({ service: 'api-gateway' });
+ *
+ * // Basic logging
+ * logger.info({ msg: 'Server started', port: 3000 });
+ *
+ * // Domain-specific logging
+ * const discoveryLog = logger.domain('discovery');
+ * discoveryLog.info({ msg: 'Job created', jobId: '123' });
+ *
+ * // Request context logging
+ * const reqLog = logger.withContext({
+ *   correlationId: 'abc-123',
+ *   tenantId: 'tenant-1',
+ *   domain: 'discovery'
+ * });
+ * reqLog.info({ msg: 'Processing request' });
+ * ```
+ *
+ * CloudWatch Insights queries:
+ * - Filter by service: `fields @timestamp, @message | filter service = "api-gateway"`
+ * - Filter by domain: `fields @timestamp, @message | filter domain = "discovery"`
+ * - Filter errors: `fields @timestamp, @message | filter level = "error"`
+ * - Filter by tenant: `fields @timestamp, @message | filter tenant_id = "xxx"`
+ */
+export declare function createLogger(config: LoggerConfig): ArivLogger;
+/**
+ * Create a domain-specific child logger
+ * @deprecated Use logger.domain() instead
+ */
+export declare function createDomainLogger(logger: PinoLogger, domain: LogDomain): PinoLogger;
+/**
+ * Create a child logger with request context
+ * @deprecated Use logger.withContext() instead
+ */
+export declare function createRequestLogger(logger: PinoLogger, domain: LogDomain, correlationId: string, userId?: string, tenantId?: string): PinoLogger;
+export type { Logger as PinoLogger } from 'pino';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAiB,MAAM,MAAM,CAAC;AAGhE;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,eAAe,GACf,0BAA0B,GAC1B,sBAAsB,GACtB,mBAAmB,GACnB,UAAU,GACV,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,MAAM,GACN,YAAY,GACZ,WAAW,GACX,SAAS,GACT,YAAY,GACZ,OAAO,GACP,OAAO,GACP,WAAW,GACX,UAAU,GACV,SAAS,GACT,OAAO,GACP,OAAO,GACP,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,kDAAkD;IAClD,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,UAAU,CAAC;IAC1C,iDAAiD;IACjD,WAAW,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,UAAU,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CA2D7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,CAEpF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CAOZ;AAGD,YAAY,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+exports.createDomainLogger = createDomainLogger;
+exports.createRequestLogger = createRequestLogger;
+const pino_1 = __importDefault(require("pino"));
+/**
+ * Create a structured logger for an ArivLabs service
+ *
+ * @example
+ * ```typescript
+ * import { createLogger } from '@arivlabs/logger';
+ *
+ * const logger = createLogger({ service: 'api-gateway' });
+ *
+ * // Basic logging
+ * logger.info({ msg: 'Server started', port: 3000 });
+ *
+ * // Domain-specific logging
+ * const discoveryLog = logger.domain('discovery');
+ * discoveryLog.info({ msg: 'Job created', jobId: '123' });
+ *
+ * // Request context logging
+ * const reqLog = logger.withContext({
+ *   correlationId: 'abc-123',
+ *   tenantId: 'tenant-1',
+ *   domain: 'discovery'
+ * });
+ * reqLog.info({ msg: 'Processing request' });
+ * ```
+ *
+ * CloudWatch Insights queries:
+ * - Filter by service: `fields @timestamp, @message | filter service = "api-gateway"`
+ * - Filter by domain: `fields @timestamp, @message | filter domain = "discovery"`
+ * - Filter errors: `fields @timestamp, @message | filter level = "error"`
+ * - Filter by tenant: `fields @timestamp, @message | filter tenant_id = "xxx"`
+ */
+function createLogger(config) {
+    const isDevelopment = config.environment === 'development' || process.env.NODE_ENV === 'development';
+    const isLocal = process.env.ENV === 'local';
+    const shouldPrettyPrint = config.pretty ?? (isDevelopment || isLocal);
+    const pinoOptions = {
+        name: config.service,
+        level: config.level || process.env.LOG_LEVEL || (isDevelopment ? 'debug' : 'info'),
+        // Base fields included in every log
+        base: {
+            service: config.service,
+            environment: config.environment || process.env.ENV || process.env.NODE_ENV || 'development',
+        },
+        // Timestamp format (CloudWatch-friendly ISO 8601)
+        timestamp: () => `,"timestamp":"${new Date().toISOString()}"`,
+        // Serializers for common objects
+        serializers: {
+            req: pino_1.default.stdSerializers.req,
+            res: pino_1.default.stdSerializers.res,
+            err: pino_1.default.stdSerializers.err,
+        },
+    };
+    // Add pretty printing for development
+    if (shouldPrettyPrint) {
+        pinoOptions.transport = {
+            target: 'pino-pretty',
+            options: {
+                colorize: true,
+                translateTime: 'HH:MM:ss Z',
+                ignore: 'pid,hostname',
+                messageFormat: '[{service}:{domain}] {correlation_id} {msg}',
+            },
+        };
+    }
+    const baseLogger = (0, pino_1.default)(pinoOptions);
+    // Extend with domain and context methods
+    const logger = baseLogger;
+    logger.domain = (domain) => {
+        return baseLogger.child({ domain });
+    };
+    logger.withContext = (context) => {
+        return baseLogger.child({
+            domain: context.domain,
+            correlation_id: context.correlationId,
+            user_id: context.userId,
+            tenant_id: context.tenantId,
+        });
+    };
+    return logger;
+}
+/**
+ * Create a domain-specific child logger
+ * @deprecated Use logger.domain() instead
+ */
+function createDomainLogger(logger, domain) {
+    return logger.child({ domain });
+}
+/**
+ * Create a child logger with request context
+ * @deprecated Use logger.withContext() instead
+ */
+function createRequestLogger(logger, domain, correlationId, userId, tenantId) {
+    return logger.child({
+        domain,
+        correlation_id: correlationId,
+        user_id: userId,
+        tenant_id: tenantId,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAmGA,oCA2DC;AAMD,gDAEC;AAMD,kDAaC;AAxLD,gDAAwB;AAmExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,SAAgB,YAAY,CAAC,MAAoB;IAC/C,MAAM,aAAa,GACjB,MAAM,CAAC,WAAW,KAAK,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC;IACjF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,OAAO,CAAC;IAC5C,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,CAAC;IAEtE,MAAM,WAAW,GAAkB;QACjC,IAAI,EAAE,MAAM,CAAC,OAAO;QACpB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAElF,oCAAoC;QACpC,IAAI,EAAE;YACJ,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa;SAC5F;QAED,kDAAkD;QAClD,SAAS,EAAE,GAAG,EAAE,CAAC,iBAAiB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG;QAE7D,iCAAiC;QACjC,WAAW,EAAE;YACX,GAAG,EAAE,cAAI,CAAC,cAAc,CAAC,GAAG;YAC5B,GAAG,EAAE,cAAI,CAAC,cAAc,CAAC,GAAG;YAC5B,GAAG,EAAE,cAAI,CAAC,cAAc,CAAC,GAAG;SAC7B;KACF,CAAC;IAEF,sCAAsC;IACtC,IAAI,iBAAiB,EAAE,CAAC;QACtB,WAAW,CAAC,SAAS,GAAG;YACtB,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,YAAY;gBAC3B,MAAM,EAAE,cAAc;gBACtB,aAAa,EAAE,6CAA6C;aAC7D;SACF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,cAAI,EAAC,WAAW,CAAC,CAAC;IAErC,yCAAyC;IACzC,MAAM,MAAM,GAAG,UAAwB,CAAC;IAExC,MAAM,CAAC,MAAM,GAAG,CAAC,MAAiB,EAAE,EAAE;QACpC,OAAO,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,CAAC,OAAuB,EAAE,EAAE;QAC/C,OAAO,UAAU,CAAC,KAAK,CAAC;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,cAAc,EAAE,OAAO,CAAC,aAAa;YACrC,OAAO,EAAE,OAAO,CAAC,MAAM;YACvB,SAAS,EAAE,OAAO,CAAC,QAAQ;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,MAAkB,EAAE,MAAiB;IACtE,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,MAAkB,EAClB,MAAiB,EACjB,aAAqB,EACrB,MAAe,EACf,QAAiB;IAEjB,OAAO,MAAM,CAAC,KAAK,CAAC;QAClB,MAAM;QACN,cAAc,EAAE,aAAa;QAC7B,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

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

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

package/dist/index.test.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+// Use the mock from __mocks__ folder
+jest.mock('pino');
+describe('@arivlabs/logger', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    describe('createLogger', () => {
+        it('should create a logger with required service name', () => {
+            const logger = (0, index_1.createLogger)({ service: 'api-gateway' });
+            expect(logger).toBeDefined();
+            expect(typeof logger.info).toBe('function');
+            expect(typeof logger.error).toBe('function');
+            expect(typeof logger.warn).toBe('function');
+            expect(typeof logger.debug).toBe('function');
+        });
+        it('should accept all valid service names', () => {
+            const services = [
+                'api-gateway',
+                'queue-manager',
+                'scanner-result-processor',
+                'enrichment-processor',
+                'lineage-processor',
+                'ai-proxy',
+                'control-plane',
+            ];
+            services.forEach((service) => {
+                const logger = (0, index_1.createLogger)({ service });
+                expect(logger).toBeDefined();
+            });
+        });
+        it('should accept custom service names', () => {
+            const logger = (0, index_1.createLogger)({ service: 'custom-service' });
+            expect(logger).toBeDefined();
+        });
+        it('should create logger with optional environment', () => {
+            const logger = (0, index_1.createLogger)({
+                service: 'api-gateway',
+                environment: 'production',
+            });
+            expect(logger).toBeDefined();
+        });
+        it('should create logger with optional log level', () => {
+            const logger = (0, index_1.createLogger)({
+                service: 'api-gateway',
+                level: 'debug',
+            });
+            expect(logger).toBeDefined();
+        });
+        it('should create logger with pretty printing disabled', () => {
+            const logger = (0, index_1.createLogger)({
+                service: 'api-gateway',
+                pretty: false,
+            });
+            expect(logger).toBeDefined();
+        });
+    });
+    describe('logger.domain()', () => {
+        it('should create a child logger with domain', () => {
+            const logger = (0, index_1.createLogger)({ service: 'api-gateway' });
+            const discoveryLogger = logger.domain('discovery');
+            expect(logger.child).toHaveBeenCalledWith({ domain: 'discovery' });
+            expect(discoveryLogger).toBeDefined();
+        });
+        it('should accept all valid domains', () => {
+            const logger = (0, index_1.createLogger)({ service: 'api-gateway' });
+            const domains = [
+                'discovery',
+                'auth',
+                'connectors',
+                'inventory',
+                'lineage',
+                'onboarding',
+                'proxy',
+                'users',
+                'dashboard',
+                'internal',
+                'storage',
+                'email',
+                'queue',
+                'system',
+            ];
+            domains.forEach((domain) => {
+                logger.domain(domain);
+                expect(logger.child).toHaveBeenCalledWith({ domain });
+            });
+        });
+    });
+    describe('logger.withContext()', () => {
+        it('should create a child logger with full context', () => {
+            const logger = (0, index_1.createLogger)({ service: 'api-gateway' });
+            const requestLogger = logger.withContext({
+                correlationId: 'abc-123',
+                userId: 'user-456',
+                tenantId: 'tenant-789',
+                domain: 'discovery',
+            });
+            expect(logger.child).toHaveBeenCalledWith({
+                domain: 'discovery',
+                correlation_id: 'abc-123',
+                user_id: 'user-456',
+                tenant_id: 'tenant-789',
+            });
+            expect(requestLogger).toBeDefined();
+        });
+        it('should create a child logger with minimal context', () => {
+            const logger = (0, index_1.createLogger)({ service: 'api-gateway' });
+            logger.withContext({
+                correlationId: 'abc-123',
+            });
+            expect(logger.child).toHaveBeenCalledWith({
+                domain: undefined,
+                correlation_id: 'abc-123',
+                user_id: undefined,
+                tenant_id: undefined,
+            });
+        });
+        it('should create a child logger with correlation and tenant only', () => {
+            const logger = (0, index_1.createLogger)({ service: 'api-gateway' });
+            logger.withContext({
+                correlationId: 'abc-123',
+                tenantId: 'tenant-789',
+            });
+            expect(logger.child).toHaveBeenCalledWith({
+                domain: undefined,
+                correlation_id: 'abc-123',
+                user_id: undefined,
+                tenant_id: 'tenant-789',
+            });
+        });
+    });
+    describe('type exports', () => {
+        it('should export ServiceName type', () => {
+            const service = 'api-gateway';
+            expect(service).toBe('api-gateway');
+        });
+        it('should export LogDomain type', () => {
+            const domain = 'discovery';
+            expect(domain).toBe('discovery');
+        });
+        it('should export ArivLogger type', () => {
+            const logger = (0, index_1.createLogger)({ service: 'api-gateway' });
+            expect(logger).toBeDefined();
+        });
+    });
+    describe('environment defaults', () => {
+        const originalEnv = process.env;
+        beforeEach(() => {
+            process.env = { ...originalEnv };
+        });
+        afterAll(() => {
+            process.env = originalEnv;
+        });
+        it('should default to debug level in development', () => {
+            process.env.NODE_ENV = 'development';
+            const logger = (0, index_1.createLogger)({ service: 'api-gateway' });
+            expect(logger).toBeDefined();
+        });
+        it('should default to info level in production', () => {
+            process.env.NODE_ENV = 'production';
+            const logger = (0, index_1.createLogger)({
+                service: 'api-gateway',
+                environment: 'production',
+            });
+            expect(logger).toBeDefined();
+        });
+        it('should respect LOG_LEVEL env variable', () => {
+            process.env.LOG_LEVEL = 'warn';
+            const logger = (0, index_1.createLogger)({ service: 'api-gateway' });
+            expect(logger).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@arivlabs/logger",
+  "version": "1.0.0",
+  "description": "Structured logging for Node.js services with CloudWatch support",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "pnpm run build"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "pino": "^9.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {
+    "pino-pretty": "^13.0.0"
+  },
+  "peerDependenciesMeta": {
+    "pino-pretty": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "logging",
+    "pino",
+    "cloudwatch",
+    "structured-logging",
+    "nodejs",
+    "typescript"
+  ],
+  "author": "ArivLabs <hello@arivlabs.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/ArivLabs/arivlabs-packages/tree/main/packages/logger#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArivLabs/arivlabs-packages.git",
+    "directory": "packages/logger"
+  },
+  "bugs": {
+    "url": "https://github.com/ArivLabs/arivlabs-packages/issues"
+  }
+}