esbuild-plugin-pino
Advanced tools
An esbuild plugin to generate extra pino files for bundling
npm install esbuild-plugin-pino
This plugin allows to use of pino v7 ~ v9 with esbuild generated bundle files.
Note that, due to pino architecture (based on Node.js' Worker Threads), it is not possible to make it work without generating extra files.
This means that when using this plugin the following list of files will be generated at the root of your dist folder:
thread-stream.jspino-worker.jspino-pipeline-worker.js (no longer required after Pino v9.1.0)pino-file.jsA file for each transport you specify in the plugin constructor's transports option. (see below)
Each of the additional file is a bundle and therefore does not contain any external dependency, but it is needed to use pino and it must be included in the deployment.
Simply include the plugin in your esbuild build script. Make sure you provide the plugin a list of all the pino transports you use via the transports option (pino/file is always included so no need to specify it).
// General usage
const { build } = require("esbuild");
const esbuildPluginPino = require("esbuild-plugin-pino");
build({
entryPoints: ["src/index.ts"],
outdir: "dist",
plugins: [esbuildPluginPino({ transports: ["pino-pretty"] })],
}).catch(() => process.exit(1));
// Multiple entryPoints & pino transports
const { build } = require("esbuild");
const esbuildPluginPino = require("esbuild-plugin-pino");
build({
entryPoints: {
first: "./first.js",
"abc/cde/second": "./second.js",
},
outdir: "dist",
plugins: [esbuildPluginPino({ transports: ["pino-pretty", "pino-loki"] })],
}).catch(() => process.exit(1));
// Start from esbuild@^0.17.1
// Multiple entryPoints in an array of object & pino transports
const { build } = require("esbuild");
const esbuildPluginPino = require("esbuild-plugin-pino");
build({
entryPoints: [
{
in: "./test/fixtures/first.js",
out: "first",
},
{
in: "./test/fixtures/second.js",
out: "abc/cde/second",
},
],
outdir: "dist",
plugins: [esbuildPluginPino({ transports: ["pino-pretty", "pino-loki"] })],
}).catch(() => process.exit(1));
If you use docker or severless function like AWS Lambda, make sure to use the same outdir in your production.
Ex: If your outdir is set to dist in esbuild, you need to copy the whole dist but not extracting files into the docker image root folder.
2.2.1 (2024-11-09)
FAQs
An esbuild plugin to generate extra pino files for bundling
The npm package esbuild-plugin-pino receives a total of 49,769 weekly downloads. As such, esbuild-plugin-pino popularity was classified as popular.
We found that esbuild-plugin-pino demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.