Installation

Requirements

Requirement	Minimum
Node.js	18.x or later
TypeScript	4.7 or later (optional)
Browser	Chrome 90+, Firefox 88+, Safari 14+
Runtime dependencies	0

---

Package managers

npm

npm install @gouranga_samrat/log-wiz

yarn

yarn add @gouranga_samrat/log-wiz

pnpm

pnpm add @gouranga_samrat/log-wiz

bun

bun add @gouranga_samrat/log-wiz

---

Module formats

log-wiz ships four compiled targets. Your toolchain picks the right one automatically via the exports field in package.json.

Format	Path	Used by
ESM	dist/esm/	Vite, Rollup, esbuild, native import
CJS	dist/cjs/	Node.js require(), Jest
Browser	dist/browser/	Browser bundles — fs/path excluded
Types	dist/types/	TypeScript declarations

Note

The browser export condition strips all Node.js file-system code, keeping the browser bundle under 1.5 KB gzipped.

---

TypeScript setup

log-wiz works with any reasonable tsconfig.json. For best results:

{
  "compilerOptions": {
    "strict": true,
    "moduleResolution": "bundler",
    "esModuleInterop": true
  }
}

All types ship with the package — no @types/ package needed:

import type {
  WizConfig,
  LogEntry,
  LogLevel,
  Transport,
} from "@gouranga_samrat/log-wiz";

---

Verify installation

node -e "import('@gouranga_samrat/log-wiz').then(m => m.wiz.info('install OK'))"

Expected output:

INF  2024-05-15 14:32:01.123  install OK