@mtth/stl-utils

@mtth/stl-utils

Infrastructure-friendly utilities: typed event emitters, bindable server lifecycles, pretty printers, environment helpers, and more.

Quickstart

pnpm add @mtth/stl-utils

import {typedEmitter} from '@mtth/stl-utils/events';
import {PrettyFormatter} from '@mtth/stl-utils/objects';

interface WorkerEvents {
  ready(): void;
  failed(err: unknown): void;
}

const events = typedEmitter<WorkerEvents>();
events.on('ready', () => console.log('ready for traffic'));
events.emit('ready');

const pretty = PrettyFormatter.create();
console.log(pretty.format({token: Buffer.alloc(256)}));

Highlights

• Type-safe emitters via typedEmitter, withEmitter, and withTypedEmitter keep Node-style event code honest without third-party wrappers.
• Bindable, Host, and serverHost standardize how long-running services bind, emit lifecycle events, and react to signals.
• Formatting helpers (PrettyFormatter, relative indexable views, truncation) keep structured logs readable even with large payloads or buffers.
• A grab bag of ergonomic primitives (environment inspection, strings, collections, opaque nominal types) removes incidental plumbing from higher-level packages.