Bundilio: Simple JavaScript File Concatenator

Common errors

• TypeError: bundilio is not a function

  cause Attempting to call `require('bundilio')()` directly, or mistakenly using destructuring assignment `const { bundle } = require('bundilio')`.
  fix The `bundilio` package's `module.exports` *is* the `bundle` function itself. Correct usage is `const bundle = require('bundilio');`

• Error: ENOENT: no such file or directory, open '<path/to/file>'

  cause One of the input files specified in the `files` array does not exist at the provided path, or the output directory for the bundled file does not exist.
  fix Verify all input file paths are correct and the files exist. Ensure the target directory for the output bundle exists before running Bundilio, or create it programmatically using `fs.mkdirSync(outputDir, { recursive: true });`.

Warnings

• breaking The `bundilio` package is abandoned and has not been updated in over 7 years. It is highly insecure and incompatible with modern JavaScript development practices and environments, posing significant risks for production use.
  Fix: Immediately migrate to a actively maintained and secure modern bundler such as Webpack, Rollup, Parcel, or esbuild for any project.
• gotcha Bundilio is a simple file concatenator, not a module bundler. It does not perform dependency resolution, tree-shaking, transpilation (e.g., ES6+ to ES5), code splitting, minification, or handle non-JavaScript assets (CSS, images).
  Fix: Understand its severe limitations and use it only for extremely basic file concatenation if absolutely necessary. For any non-trivial or modern project, a dedicated module bundler is required.
• gotcha This package only supports CommonJS (CJS) modules. It will not correctly process or understand ES Modules (ESM) `import`/`export` syntax, leading to syntax errors or incorrectly formed bundles.
  Fix: Ensure all input files use CommonJS `require()` syntax. For projects using ESM, switch to a modern bundler that fully supports ES Modules.

Install

• npm install bundilio npm
• yarn add bundilio yarn
• pnpm add bundilio pnpm

Imports

• bundle
  wrong:

  import { bundle } from 'bundilio';
  // or
  const { bundle } = require('bundilio');

  correct:

  const bundle = require('bundilio');

  This package is CommonJS-only and exports the `bundle` function directly as its `module.exports`. It does not support ES Modules (ESM) syntax like `import`/`export`.

Quickstart

Demonstrates how to use Bundilio to concatenate multiple JavaScript source files into a single output file using its CommonJS API. It creates temporary source files and an output directory.

const fs = require('fs');
const path = require('path');
const bundle = require('bundilio');

const inputDir = path.join(__dirname, 'src');
const outputDir = path.join(__dirname, 'dist');

// Create dummy source files
fs.mkdirSync(inputDir, { recursive: true });
fs.writeFileSync(path.join(inputDir, 'moduleA.js'), 'console.log("Module A loaded");\nmodule.exports = { name: "A" };');
fs.writeFileSync(path.join(inputDir, 'moduleB.js'), 'console.log("Module B loaded");\nmodule.exports = { value: 123 };');

// Ensure output directory exists
fs.mkdirSync(outputDir, { recursive: true });

const inputFiles = [
  path.join(inputDir, 'moduleA.js'),
  path.join(inputDir, 'moduleB.js')
];
const outputFile = path.join(outputDir, 'app.bundle.js');

bundle(inputFiles, outputFile, (err) => {
  if (err) {
    console.error('Bundling failed:', err);
    return;
  }
  console.log(`Successfully bundled ${inputFiles.length} files to ${outputFile}`);
  const bundledContent = fs.readFileSync(outputFile, 'utf8');
  console.log('\n--- Bundled Content ---');
  console.log(bundledContent);
  console.log('--------------------');
});