# @rocicorp/logger

> Logging utilities

Latest version **6.2.0** (published 2026-07-02) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @rocicorp/logger
pnpm add @rocicorp/logger
yarn add @rocicorp/logger
bun add @rocicorp/logger
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 6.2.0 |
| Published | 2026-07-02 |
| First published | 2022-03-17 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 25.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 14 |
| Maintainers | arv, aboodman, cesaraz1, grgbkr, 0xcadams, tantaman, darick |

## Links

- npm: https://www.npmjs.com/package/@rocicorp/logger
- Repository: https://github.com/rocicorp/logger
- npm.io page: https://npm.io/package/@rocicorp/logger

## Recent versions

- 6.2.0 (latest) — 2026-07-02
- 6.1.0 — 2026-06-23
- 6.0.0 — 2026-06-15
- 5.5.0 — 2026-06-15
- 5.4.0 — 2025-04-17
- 5.3.0 — 2024-10-09
- 5.2.2 — 2024-06-03
- 5.2.1 — 2023-09-12
- 5.2.0 — 2023-06-09
- 5.1.0 — 2023-05-24
- 5.0.0 — 2023-05-19
- 4.1.0 — 2023-03-07
- 4.0.0 — 2023-01-25
- 3.0.0 — 2023-01-25
- 2.2.0 — 2022-03-31
- … 6 more at https://npm.io/package/@rocicorp/logger/versions

## README

# logger

Provides a simple logging interface as well as a `LogContext` class which
carries a context around.

# Installation

```
npm install @rocicorp/logger
```

# Usage

## LogContext

`LogContext` includes a context that gets included in the log message.

```js
import {LogContext} from '@rocicorp/logger';

const lc = new LogContext('info');
lc.info('hello'); // prints "hello"

const lc2 = new LogContext('info', {name: 'alice'});
lc.info('hello'); // prints "name=alice hello"

const lc3 = lc2.withContext('bbb');
lc3.info('hello'); // prints "name=alice bbb hello"

const lc4 = lc3.withContext('ccc');
lc4.info('hello'); // prints "name=alice bbb ccc hello"

const lc5 = lc4.withContext('ddd', 'eee');
lc5.info('hello'); // prints "name=alice bbb ccc ddd=eee hello"

// Or get a context logger appropriate for the Node environment.
const nlc = newNodeLogContext('debug');
nlc.info('fff'); // prints "INF fff"
```

## OptionalLogger

```ts
interface OptionalLogger { ... }
```

This interface is used to provide conditional logging. It is intended to be used
with conditional method calling `?.()`.

```ts
import {ConsoleLogger, type OptionalLogger} from '@rocicorp/logger';

const l: OptionalLogger = new ConsoleLogger('info');
l.info?.('hello'); // prints "hello"
l.debug?.('hello'); // does not print anything
```

But more importantly it does not evaluate the arguments.

```ts
import {ConsoleLogger, type OptionalLogger} from '@rocicorp/logger';
const alwaysThrows = () => {
  throw new Error();
};
const l: OptionalLogger = new ConsoleLogger('info');
l.debug?.(alwaysThrows()); // does not print anything, but does not throw
```

# Implementing Your Own `LogSink`

There is also the `LogSink` interface which is very minimal. Its intended use is
for custom log implementations.

```ts
class ExampleLogSink implements LogSink {
  log(level: LogLevel, ...args: unknown[]): void {
    //...
  }
}
```

You can get an `OptionalLogger` from a `LogSink` using `OptionalLoggerImpl`.

```ts
import {
  OptionalLoggerImpl,
  type LogSink,
  type OptionalLogger,
} from '@rocicorp/logger';

const logSink: LogSink = new ExampleLogSink();
const l: OptionalLogger = new OptionalLoggerImpl(logSink);
```

---
_Source: https://npm.io/package/@rocicorp/logger · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
