@crossplatformai/logger

Shared logger module for CrossPlatform.ai projects.

This package provides one small logger factory that supports pretty development output and structured production JSON output.

What this package provides

• createLogger() for creating logger instances with debug, info, warn, and error methods
• ISO timestamped development logs
• Structured JSON production logs
• Optional log prefixes for worker or service names
• Error and circular value serialization

Package boundary

This package owns:

• log level filtering
• development and production log formatting
• structured data serialization
• error serialization

This package does not own:

• log shipping or transports
• file output
• tracing
• global singleton management
• console monkey-patching

Installation

pnpm add @crossplatformai/logger

Usage

import { createLogger } from '@crossplatformai/logger';

const logger = createLogger({
  level: 'info',
  mode: process.env.NODE_ENV === 'production' ? 'production' : 'development',
  prefix: 'api',
});

logger.info('Service started', {
  port: 3000,
  region: 'local',
});

Development output:

[2026-05-12T23:54:00.000Z] [INFO] [api] Service started { port: 3000, region: 'local' }

Production output:

{
  "timestamp": "2026-05-12T23:54:00.000Z",
  "level": "info",
  "prefix": "api",
  "message": "Service started",
  "data": { "port": 3000, "region": "local" }
}

Import paths

• @crossplatformai/logger - main export (createLogger and types)

Configuration

interface LoggerConfig {
  level: 'debug' | 'info' | 'warn' | 'error' | 'silent';
  mode: 'development' | 'production';
  prefix?: string;
}

Publishing model

This package currently publishes raw TypeScript source.

That is intentional for now. Consuming repos are expected to use toolchains that can consume package TypeScript directly.

Testing

pnpm test
pnpm typecheck
pnpm lint

License

See LICENSE.