@contrail/util 1.2.0 → 1.2.1-alpha-otel-logs-2

package/CHANGELOG.md

@@ -1,6 +1,17 @@
 # Changelog
 
-## 1.2.0 (2026-03-09)
+All notable changes to `@contrail/util` are documented here.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Changed
+
+- Replaced `console.log/warn/error` calls with structured logger from `@contrail/telemetry`. No API changes. On the backend, logs are now captured by the OTel pipeline. In the browser, behavior is unchanged (Pino delegates to native console).
+
+## [1.2.0] - 2026-03-09
 
 ### Added
 
@@ -12,6 +23,6 @@
   - Converts `bigint`, `symbol`, and `function` values to strings
   - Skips `null` and `undefined` values
 
-## 1.1.19
+## [1.1.19] - 2026-03-01
 
 - Previous stable release

package/lib/compression-util/compression.js

@@ -3,10 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.compressIntoString = compressIntoString;
 exports.decompressFromString = decompressFromString;
 const fflate_1 = require("fflate");
+const telemetry_1 = require("@contrail/telemetry");
 function compressIntoString(obj) {
     const jsonStr = JSON.stringify(obj === undefined ? null : obj);
     if (typeof Buffer === 'undefined') {
-        console.warn('Buffer is not available. Compression will be skipped.');
+        telemetry_1.logger.warn('Buffer is not available. Compression will be skipped.');
         return jsonStr;
     }
     const buffer = new TextEncoder().encode(jsonStr);
@@ -15,7 +16,7 @@ function compressIntoString(obj) {
 }
 function decompressFromString(str) {
     if (typeof Buffer === 'undefined') {
-        console.warn('Buffer is not available. Decompression will be skipped. Returning original string.');
+        telemetry_1.logger.warn('Buffer is not available. Decompression will be skipped. Returning original string.');
         return str;
     }
     const compressed = Buffer.from(str, 'base64');

package/lib/date-util/getIsoDatePart/getIsoDatePart.js

@@ -2,9 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getIsoDatePart = getIsoDatePart;
 function getIsoDatePart(date) {
-    console.log('date 1: ', date.toISOString(), '\n\n\n\n\n\n\n\n');
     let d = new Date(date);
-    console.log('date 2: ', d.toISOString(), '\n\n\n\n\n\n\n\n');
     let month = '' + (d.getMonth() + 1), day = '' + d.getDate(), year = d.getFullYear();
     if (month.length < 2) {
         month = '0' + month;

package/lib/performance-util/example-usage.js

@@ -10,17 +10,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const performance_util_1 = require("./performance-util");
+const telemetry_1 = require("@contrail/telemetry");
 function demonstrateStartEndSpan() {
-    console.log('--- Demonstrating startSpan/endSpan functionality ---\n');
+    telemetry_1.logger.debug('--- Demonstrating startSpan/endSpan functionality ---\n');
     (0, performance_util_1.clearDefaultTimingProfile)();
-    console.log('Example 1: Simple span');
+    telemetry_1.logger.debug('Example 1: Simple span');
     (0, performance_util_1.startSpan)('Data Processing');
     const start1 = performance.now();
     while (performance.now() < start1 + 100) {
     }
     (0, performance_util_1.endSpan)('Data Processing');
     (0, performance_util_1.displayTimingTree)();
-    console.log('\nExample 2: Nested spans');
+    telemetry_1.logger.debug('\nExample 2: Nested spans');
     (0, performance_util_1.clearDefaultTimingProfile)();
     (0, performance_util_1.startSpan)('Complete Task');
     (0, performance_util_1.startSpan)('Initialization');
@@ -47,7 +48,7 @@ function demonstrateStartEndSpan() {
     (0, performance_util_1.endSpan)('Cleanup');
     (0, performance_util_1.endSpan)('Complete Task');
     (0, performance_util_1.displayTimingTree)();
-    console.log('\nExample 3: Multiple sequential spans');
+    telemetry_1.logger.debug('\nExample 3: Multiple sequential spans');
     (0, performance_util_1.clearDefaultTimingProfile)();
     (0, performance_util_1.startSpan)('Phase 1');
     const start6 = performance.now();
@@ -67,49 +68,49 @@ function demonstrateStartEndSpan() {
     (0, performance_util_1.displayTimingTree)();
 }
 function demonstrateWarningBehavior() {
-    console.log('\n--- Demonstrating Warning Behavior ---\n');
+    telemetry_1.logger.debug('\n--- Demonstrating Warning Behavior ---\n');
     (0, performance_util_1.clearDefaultTimingProfile)();
-    console.log('Example 4: Warning behavior');
+    telemetry_1.logger.debug('Example 4: Warning behavior');
     (0, performance_util_1.startSpan)('Test Span');
-    console.log('Started "Test Span"');
+    telemetry_1.logger.debug('Started "Test Span"');
     (0, performance_util_1.startSpan)('Test Span');
-    console.log('Attempted to start "Test Span" again (should see warning above)');
+    telemetry_1.logger.debug('Attempted to start "Test Span" again (should see warning above)');
     (0, performance_util_1.endSpan)('Test Span');
-    console.log('Ended "Test Span"');
+    telemetry_1.logger.debug('Ended "Test Span"');
     (0, performance_util_1.endSpan)('Non-existent Span');
-    console.log('Attempted to end "Non-existent Span" (should see warning above)');
+    telemetry_1.logger.debug('Attempted to end "Non-existent Span" (should see warning above)');
     (0, performance_util_1.displayTimingTree)();
 }
 function demonstrateParentNodeId() {
     return __awaiter(this, void 0, void 0, function* () {
-        console.log('\n--- Demonstrating parentNodeId Functionality ---\n');
+        telemetry_1.logger.debug('\n--- Demonstrating parentNodeId Functionality ---\n');
         (0, performance_util_1.clearDefaultTimingProfile)();
-        console.log('Example 5: Concurrent async operations with explicit parent');
+        telemetry_1.logger.debug('Example 5: Concurrent async operations with explicit parent');
         yield (0, performance_util_1.withTimingAsync)('Main Operation', () => __awaiter(this, void 0, void 0, function* () {
             const mainOpId = (0, performance_util_1.getCurrentParentNodeId)();
-            console.log(`Main Operation ID: ${String(mainOpId)}`);
-            console.log('Starting concurrent operations...');
+            telemetry_1.logger.debug(`Main Operation ID: ${String(mainOpId)}`);
+            telemetry_1.logger.debug('Starting concurrent operations...');
             const results = yield Promise.all([
                 (0, performance_util_1.withTimingAsync)('Fetch User Data', () => __awaiter(this, void 0, void 0, function* () {
                     yield new Promise((resolve) => setTimeout(resolve, 80));
-                    console.log('  ✓ User data fetched');
+                    telemetry_1.logger.debug('  ✓ User data fetched');
                     return 'user-data';
                 }), { parentNodeId: mainOpId }),
                 (0, performance_util_1.withTimingAsync)('Fetch Permissions', () => __awaiter(this, void 0, void 0, function* () {
                     yield new Promise((resolve) => setTimeout(resolve, 60));
-                    console.log('  ✓ Permissions fetched');
+                    telemetry_1.logger.debug('  ✓ Permissions fetched');
                     return 'permissions-data';
                 }), { parentNodeId: mainOpId }),
                 (0, performance_util_1.withTimingAsync)('Fetch Preferences', () => __awaiter(this, void 0, void 0, function* () {
                     yield new Promise((resolve) => setTimeout(resolve, 100));
-                    console.log('  ✓ Preferences fetched');
+                    telemetry_1.logger.debug('  ✓ Preferences fetched');
                     return 'preferences-data';
                 }), { parentNodeId: mainOpId }),
             ]);
-            console.log('All concurrent operations completed:', results);
+            telemetry_1.logger.debug(`All concurrent operations completed: ${JSON.stringify(results)}`);
             yield (0, performance_util_1.withTimingAsync)('Process Results', () => __awaiter(this, void 0, void 0, function* () {
                 yield new Promise((resolve) => setTimeout(resolve, 30));
-                console.log('  ✓ Results processed');
+                telemetry_1.logger.debug('  ✓ Results processed');
             }));
         }));
         (0, performance_util_1.displayTimingTree)();
@@ -117,140 +118,140 @@ function demonstrateParentNodeId() {
 }
 function demonstrateMixedNesting() {
     return __awaiter(this, void 0, void 0, function* () {
-        console.log('\n--- Demonstrating Mixed Natural and Explicit Nesting ---\n');
+        telemetry_1.logger.debug('\n--- Demonstrating Mixed Natural and Explicit Nesting ---\n');
         (0, performance_util_1.clearDefaultTimingProfile)();
-        console.log('Example 6: Mixed natural and explicit nesting');
+        telemetry_1.logger.debug('Example 6: Mixed natural and explicit nesting');
         yield (0, performance_util_1.withTimingAsync)('Application Startup', () => __awaiter(this, void 0, void 0, function* () {
             yield (0, performance_util_1.withTimingAsync)('Load Configuration', () => __awaiter(this, void 0, void 0, function* () {
                 yield new Promise((resolve) => setTimeout(resolve, 50));
-                console.log('  ✓ Configuration loaded');
+                telemetry_1.logger.debug('  ✓ Configuration loaded');
                 yield (0, performance_util_1.withTimingAsync)('Validate Config', () => __awaiter(this, void 0, void 0, function* () {
                     yield new Promise((resolve) => setTimeout(resolve, 20));
-                    console.log('    ✓ Configuration validated');
+                    telemetry_1.logger.debug('    ✓ Configuration validated');
                 }));
             }));
-            console.log('Starting parallel initialization...');
+            telemetry_1.logger.debug('Starting parallel initialization...');
             (0, performance_util_1.startSpan)('Initialization');
             const ininitializeId = (0, performance_util_1.getCurrentParentNodeId)();
             (0, performance_util_1.withTimingSync)('Do something before initialization', () => {
                 const start = performance.now();
                 while (performance.now() < start + 20) {
                 }
-                console.log('  ✓ Pre-initialization task completed');
+                telemetry_1.logger.debug('  ✓ Pre-initialization task completed');
             });
             yield Promise.all([
                 (0, performance_util_1.withTimingAsync)('Initialize Database', () => __awaiter(this, void 0, void 0, function* () {
                     yield new Promise((resolve) => setTimeout(resolve, 120));
-                    console.log('  ✓ Database initialized');
+                    telemetry_1.logger.debug('  ✓ Database initialized');
                 }), { parentNodeId: ininitializeId }),
                 (0, performance_util_1.withTimingAsync)('Initialize Cache', () => __awaiter(this, void 0, void 0, function* () {
                     yield new Promise((resolve) => setTimeout(resolve, 90));
-                    console.log('  ✓ Cache initialized');
+                    telemetry_1.logger.debug('  ✓ Cache initialized');
                 }), { parentNodeId: ininitializeId }),
                 (0, performance_util_1.withTimingAsync)('Initialize Logging', () => __awaiter(this, void 0, void 0, function* () {
                     yield new Promise((resolve) => setTimeout(resolve, 40));
-                    console.log('  ✓ Logging initialized');
+                    telemetry_1.logger.debug('  ✓ Logging initialized');
                 }), { parentNodeId: ininitializeId }),
             ]);
             (0, performance_util_1.withTimingSync)('Do something after initialization', () => {
                 const start = performance.now();
                 while (performance.now() < start + 20) {
                 }
-                console.log('  ✓ Post-initialization task completed');
+                telemetry_1.logger.debug('  ✓ Post-initialization task completed');
             });
             (0, performance_util_1.endSpan)('Initialization');
             yield (0, performance_util_1.withTimingAsync)('Final Setup', () => __awaiter(this, void 0, void 0, function* () {
                 yield new Promise((resolve) => setTimeout(resolve, 30));
-                console.log('  ✓ Final setup completed');
+                telemetry_1.logger.debug('  ✓ Final setup completed');
             }));
         }));
         (0, performance_util_1.displayTimingTree)();
     });
 }
 function demonstrateSyncWithParentId() {
-    console.log('\n--- Demonstrating Sync Functions with parentNodeId ---\n');
+    telemetry_1.logger.debug('\n--- Demonstrating Sync Functions with parentNodeId ---\n');
     (0, performance_util_1.clearDefaultTimingProfile)();
-    console.log('Example 7: Sync functions with explicit parent');
+    telemetry_1.logger.debug('Example 7: Sync functions with explicit parent');
     (0, performance_util_1.withTimingSync)('Data Processing Pipeline', () => {
         const pipelineId = (0, performance_util_1.getCurrentParentNodeId)();
-        console.log(`Pipeline ID: ${String(pipelineId)}`);
+        telemetry_1.logger.debug(`Pipeline ID: ${String(pipelineId)}`);
         (0, performance_util_1.withTimingSync)('Load Input Data', () => {
             const start = performance.now();
             while (performance.now() < start + 50) {
             }
-            console.log('  ✓ Input data loaded');
+            telemetry_1.logger.debug('  ✓ Input data loaded');
         });
         (0, performance_util_1.withTimingSync)('Process Batch 1', () => {
             const start = performance.now();
             while (performance.now() < start + 80) {
             }
-            console.log('  ✓ Batch 1 processed');
+            telemetry_1.logger.debug('  ✓ Batch 1 processed');
         }, { parentNodeId: pipelineId });
         (0, performance_util_1.withTimingSync)('Process Batch 2', () => {
             const start = performance.now();
             while (performance.now() < start + 70) {
             }
-            console.log('  ✓ Batch 2 processed');
+            telemetry_1.logger.debug('  ✓ Batch 2 processed');
         }, { parentNodeId: pipelineId });
         (0, performance_util_1.withTimingSync)('Process Batch 3', () => {
             const start = performance.now();
             while (performance.now() < start + 90) {
             }
-            console.log('  ✓ Batch 3 processed');
+            telemetry_1.logger.debug('  ✓ Batch 3 processed');
         }, { parentNodeId: pipelineId });
         (0, performance_util_1.withTimingSync)('Save Results', () => {
             const start = performance.now();
             while (performance.now() < start + 40) {
             }
-            console.log('  ✓ Results saved');
+            telemetry_1.logger.debug('  ✓ Results saved');
         });
     });
     (0, performance_util_1.displayTimingTree)();
 }
 function demonstrateManualSpansWithParentId() {
-    console.log('\n--- Demonstrating Manual Spans with parentNodeId ---\n');
+    telemetry_1.logger.debug('\n--- Demonstrating Manual Spans with parentNodeId ---\n');
     (0, performance_util_1.clearDefaultTimingProfile)();
-    console.log('Example 8: Manual spans with explicit parent');
+    telemetry_1.logger.debug('Example 8: Manual spans with explicit parent');
     (0, performance_util_1.startSpan)('Service Request');
     const serviceId = (0, performance_util_1.getCurrentParentNodeId)();
-    console.log(`Service Request ID: ${String(serviceId)}`);
+    telemetry_1.logger.debug(`Service Request ID: ${String(serviceId)}`);
     (0, performance_util_1.startSpan)('Authenticate User');
     const start1 = performance.now();
     while (performance.now() < start1 + 30) {
     }
     (0, performance_util_1.endSpan)('Authenticate User');
-    console.log('  ✓ User authenticated');
+    telemetry_1.logger.debug('  ✓ User authenticated');
     (0, performance_util_1.startSpan)('Validate Input', { parentNodeId: serviceId });
     const start2 = performance.now();
     while (performance.now() < start2 + 20) {
     }
     (0, performance_util_1.endSpan)('Validate Input');
-    console.log('  ✓ Input validated');
+    telemetry_1.logger.debug('  ✓ Input validated');
     (0, performance_util_1.startSpan)('Check Rate Limits', { parentNodeId: serviceId });
     const start3 = performance.now();
     while (performance.now() < start3 + 15) {
     }
     (0, performance_util_1.endSpan)('Check Rate Limits');
-    console.log('  ✓ Rate limits checked');
+    telemetry_1.logger.debug('  ✓ Rate limits checked');
     (0, performance_util_1.startSpan)('Log Request', { parentNodeId: serviceId });
     const start4 = performance.now();
     while (performance.now() < start4 + 10) {
     }
     (0, performance_util_1.endSpan)('Log Request');
-    console.log('  ✓ Request logged');
+    telemetry_1.logger.debug('  ✓ Request logged');
     (0, performance_util_1.startSpan)('Process Request');
     const start5 = performance.now();
     while (performance.now() < start5 + 60) {
     }
     (0, performance_util_1.endSpan)('Process Request');
-    console.log('  ✓ Request processed');
+    telemetry_1.logger.debug('  ✓ Request processed');
     (0, performance_util_1.endSpan)('Service Request');
     (0, performance_util_1.displayTimingTree)();
 }
 function demonstrateNestingComparison() {
     return __awaiter(this, void 0, void 0, function* () {
-        console.log('\n--- Demonstrating Natural vs Explicit Nesting ---\n');
-        console.log('Natural Nesting (call stack based):');
+        telemetry_1.logger.debug('\n--- Demonstrating Natural vs Explicit Nesting ---\n');
+        telemetry_1.logger.debug('Natural Nesting (call stack based):');
         (0, performance_util_1.clearDefaultTimingProfile)();
         yield (0, performance_util_1.withTimingAsync)('Sequential Operations', () => __awaiter(this, void 0, void 0, function* () {
             yield (0, performance_util_1.withTimingAsync)('Operation 1', () => __awaiter(this, void 0, void 0, function* () {
@@ -264,7 +265,7 @@ function demonstrateNestingComparison() {
             }));
         }));
         (0, performance_util_1.displayTimingTree)();
-        console.log('\nExplicit Parent Assignment (logical grouping):');
+        telemetry_1.logger.debug('\nExplicit Parent Assignment (logical grouping):');
         (0, performance_util_1.clearDefaultTimingProfile)();
         yield (0, performance_util_1.withTimingAsync)('Parallel Operations', () => __awaiter(this, void 0, void 0, function* () {
             const parentId = (0, performance_util_1.getCurrentParentNodeId)();
@@ -292,7 +293,7 @@ function runAllExamples() {
         demonstrateSyncWithParentId();
         demonstrateManualSpansWithParentId();
         yield demonstrateNestingComparison();
-        console.log('\nAll examples completed. ');
+        telemetry_1.logger.debug('\nAll examples completed. ');
     });
 }
-runAllExamples().catch(console.error);
+runAllExamples().catch((err) => telemetry_1.logger.error({ err }, 'Example run failed'));

package/lib/performance-util/performance-util.js

@@ -17,6 +17,7 @@ exports.withTimingSync = withTimingSync;
 exports.displayTimingTree = displayTimingTree;
 exports.startSpan = startSpan;
 exports.endSpan = endSpan;
+const telemetry_1 = require("@contrail/telemetry");
 const DEFAULT_TIMING_PROFILE = {
     activeSpans: new Map(),
     spansById: new Map(),
@@ -187,15 +188,15 @@ function displayTimingTree(nodes = DEFAULT_TIMING_PROFILE.timingSpans, depth = 0
     });
     const result = lines.join('\n');
     if (depth === 0) {
-        console.log('\n--- Performance Timing Tree ---\n');
-        console.log(result);
-        console.log('\n--- End Timing ---\n');
+        telemetry_1.logger.debug('\n--- Performance Timing Tree ---\n');
+        telemetry_1.logger.debug(result);
+        telemetry_1.logger.debug('\n--- End Timing ---\n');
     }
     return result;
 }
 function startSpan(spanName, options) {
     if (DEFAULT_TIMING_PROFILE.activeSpans.has(spanName)) {
-        console.warn(`Span "${spanName}" is already active. Please end it before starting a new one with the same name.`);
+        telemetry_1.logger.warn(`Span "${spanName}" is already active. Please end it before starting a new one with the same name.`);
         return;
     }
     const startTime = performance.now();
@@ -229,7 +230,7 @@ function startSpan(spanName, options) {
 function endSpan(spanName) {
     const activeSpan = DEFAULT_TIMING_PROFILE.activeSpans.get(spanName);
     if (!activeSpan) {
-        console.warn(`No active span found with name "${spanName}". Make sure to call startSpan() first.`);
+        telemetry_1.logger.warn(`No active span found with name "${spanName}". Make sure to call startSpan() first.`);
         return;
     }
     const endTime = performance.now();

package/lib/string-util/string-util.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StringUtil = void 0;
+const telemetry_1 = require("@contrail/telemetry");
 class StringUtil {
     static convertToHyphenCase(entityName, transformToLowerCase = true) {
+        console.log('console log within convertToHyphenCase👋');
+        telemetry_1.logger.info({ entityName, transformToLowerCase }, 'Converting entity name to hyphen case');
         const slugName = entityName === null || entityName === void 0 ? void 0 : entityName.split(/(?=[A-Z])/).join('-');
         if (slugName && transformToLowerCase) {
             return slugName.toLowerCase();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/util",
-  "version": "1.2.0",
+  "version": "1.2.1-alpha-otel-logs-2",
   "description": "General JavaScript utilities",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -39,6 +39,7 @@
     "testEnvironment": "node"
   },
   "dependencies": {
+    "@contrail/telemetry": "^1.0.1-alpha-logger-1",
     "@contrail/types": "^3.1.3",
     "fflate": "^0.8.2",
     "lodash": "^4.17.21"