feat: Add centralized logging system with @link-stack/logger package

- Create new @link-stack/logger package wrapping Pino for structured logging
- Replace all console.log/error/warn statements across the monorepo
- Configure environment-aware logging (pretty-print in dev, JSON in prod)
- Add automatic redaction of sensitive fields (passwords, tokens, etc.)
- Remove dead commented-out logger file from bridge-worker
- Follow Pino's standard argument order (context object first, message second)
- Support log levels via LOG_LEVEL environment variable
- Export TypeScript types for better IDE support

This provides consistent, structured logging across all applications
and packages, making debugging easier and production logs more parseable.

packages/logger/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@link-stack/logger",
+  "version": "1.0.0",
+  "description": "Shared logging utility for Link Stack monorepo",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint . --ext .ts",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "pino": "^9.5.0",
+    "pino-pretty": "^13.0.0"
+  },
+  "devDependencies": {
+    "@link-stack/eslint-config": "*",
+    "@link-stack/typescript-config": "*",
+    "@types/node": "^22.10.5",
+    "eslint": "^9.17.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

packages/logger/src/config.ts

@@ -0,0 +1,56 @@
+import type { LoggerOptions } from 'pino';
+
+export const getLogLevel = (): string => {
+  return process.env.LOG_LEVEL || (process.env.NODE_ENV === 'production' ? 'info' : 'debug');
+};
+
+export const getPinoConfig = (): LoggerOptions => {
+  const isDevelopment = process.env.NODE_ENV !== 'production';
+  
+  const baseConfig: LoggerOptions = {
+    level: getLogLevel(),
+    formatters: {
+      level: (label) => {
+        return { level: label.toUpperCase() };
+      },
+    },
+    timestamp: () => `,"timestamp":"${new Date(Date.now()).toISOString()}"`,
+    redact: {
+      paths: [
+        'password',
+        'token',
+        'secret',
+        'api_key',
+        'apiKey',
+        'authorization',
+        'cookie',
+        '*.password',
+        '*.token',
+        '*.secret',
+        '*.api_key',
+        '*.apiKey',
+      ],
+      censor: '[REDACTED]',
+    },
+  };
+
+  if (isDevelopment) {
+    // In development, use pretty printing for better readability
+    return {
+      ...baseConfig,
+      transport: {
+        target: 'pino-pretty',
+        options: {
+          colorize: true,
+          translateTime: 'SYS:standard',
+          ignore: 'pid,hostname',
+          singleLine: false,
+          messageFormat: '{msg}',
+        },
+      },
+    };
+  }
+
+  // In production, use JSON for structured logging
+  return baseConfig;
+};

packages/logger/src/index.ts

@@ -0,0 +1,35 @@
+import pino, { Logger as PinoLogger } from 'pino';
+import { getPinoConfig } from './config';
+
+export type Logger = PinoLogger;
+
+// Create the default logger instance
+export const logger: Logger = pino(getPinoConfig());
+
+// Factory function to create child loggers with context
+export const createLogger = (name: string, context?: Record<string, any>): Logger => {
+  return logger.child({ name, ...context });
+};
+
+// Export log levels for consistency
+export const LogLevel = {
+  TRACE: 'trace',
+  DEBUG: 'debug',
+  INFO: 'info',
+  WARN: 'warn',
+  ERROR: 'error',
+  FATAL: 'fatal',
+} as const;
+
+export type LogLevelType = typeof LogLevel[keyof typeof LogLevel];
+
+// Utility to check if a log level is enabled
+export const isLogLevelEnabled = (level: LogLevelType): boolean => {
+  return logger.isLevelEnabled(level);
+};
+
+// Re-export pino types that might be useful
+export type { LoggerOptions, DestinationStream } from 'pino';
+
+// Default export for convenience
+export default logger;

packages/logger/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "es2022",
+    "lib": ["es2022"],
+    "module": "esnext",
+    "moduleResolution": "node",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "allowJs": false,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}