@statesync/core

---

@statesync/core / tagLogger

Function: tagLogger()

function tagLogger(base, tags): Logger;

Defined in: logger.ts:148

Wraps an existing Logger to inject static key-value tags into every log call.

The tags are merged into the extra payload of each debug, warn, and error call. If the original extra argument is a plain object, tags and extra are shallow-merged (with extra fields taking precedence). If extra is a non-object value, it is wrapped as { ...tags, extra: value }.

This is intentionally minimal: it does not change log levels, formatting, or the base logger's behavior. It only enriches the structured metadata.

Parameters

Parameter	Type	Description
base	Logger	The logger instance to wrap. All calls are delegated to this logger.
tags	Record<string, unknown>	A record of key-value pairs to inject into every log call's extra payload. Common use cases include windowId, sourceId, or sessionId.

Returns

Logger

A new Logger that delegates to base with enriched extra payloads.

Example

import { createConsoleLogger, tagLogger } from '@statesync/core';

const baseLogger = createConsoleLogger({ debug: true });
const logger = tagLogger(baseLogger, {
  windowId: 'win-1',
  sourceId: 'tab-abc',
});

logger.debug('snapshot applied', { revision: '42' });
// Console output includes: { windowId: 'win-1', sourceId: 'tab-abc', revision: '42' }