Registry / devops / rollup-plugin-insert

rollup-plugin-insert

library1.3.2jsnpmunverified

A Rollup plugin for string mutation operations on file contents: append, prepend, wrap, and custom transforms. Current stable version is 1.3.2 (last released March 2021). The plugin supports MagicString for source map-aware transformations, ships TypeScript types, and operates in maintenance mode with no recent activity. Key differentiators include separate importable functions, optional source map support, and file filtering via include/exclude patterns. Unlike general-purpose plugins like rollup-plugin-string, it focuses specifically on string insertion/wrapping transforms.

devops

npm install rollup-plugin-insert

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-INSE

rollup-plugin-insert

devopsjavascriptv1.3.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

append

✓ import { append } from 'rollup-plugin-insert'

✗ import append from 'rollup-plugin-insert'

append is a named export, not a default export.

prepend

✓ import { prepend } from 'rollup-plugin-insert'

✗ const prepend = require('rollup-plugin-insert').prepend

CommonJS require() works but ESM with named import is recommended.

wrap

✓ import { wrap } from 'rollup-plugin-insert'

wrap is a named export; no common wrong usage.

transform

✓ import { transform } from 'rollup-plugin-insert'

✗ import insert from 'rollup-plugin-insert'; const transform = insert.transform

Default import exists but not recommended; use named imports for tree-shaking.

Shows usage of all four main functions (append, prepend, wrap, transform) in a Rollup config.

// rollup.config.js import { append, prepend, wrap, transform } from 'rollup-plugin-insert'; export default { input: 'src/main.js', output: { file: 'dist/bundle.js', format: 'iife' }, plugins: [ append('\n// Appended footer'), prepend('// Prepended header\n'), wrap('/* start */', '/* end */'), transform((magicString, code, id) => code.toUpperCase()), ], };

Debug

Known issues

gotchaTransform callback must return a string or MagicString; returning undefined silently removes output.

fix

Always return a value from transform callback, e.g., code or magicString.toString()

affects: >=1.0.0

deprecatedThe plugin has not been updated since 2021; relies on older Rollup versions (<4).

fix

Consider migrating to alternative plugins like rollup-plugin-string or @rollup/plugin-replace if using Rollup 4+.

affects: >=1.3.2

gotchaSource map is enabled by default and may cause memory issues with large files.

fix

Explicitly set { sourceMap: false } in the options object if not needed.

affects: >=1.0.0

gotchaInclude/exclude patterns are not applied to the options object but as a separate argument.

fix

Use correct signature: append('string', { include: '**/*.txt' })

affects: >=1.0.0

Errors

Common errors & fixes

TypeError: insert.append is not a function

Using default import instead of named import; default import is an object with methods.

fix

Use named imports: import { append } from 'rollup-plugin-insert'

Error: Could not resolve 'rollup-plugin-insert'

Plugin not installed or missing from dependencies.

fix

Run npm install --save-dev rollup-plugin-insert

TypeError: Cannot read property 'transform' of undefined

Accessing .transform on the default export incorrectly.

fix

Use named import: import { transform } from 'rollup-plugin-insert'

Upgrade

Version history

1.3.2latest on npm

Audit

Dependencies

rolluprequiredpeer dependency; the plugin requires Rollup's plugin API and MagicString

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/rx-ts/rollup ↗

packagehttps://www.npmjs.com/package/rollup-plugin-insert ↗