naka-bundler

library0.0.7jsnpmunverified

The `naka-bundler` package (current version 0.0.7) provides a specialized command-line interface (CLI) for bundling and transpiling JavaScript and TypeScript files. It acts as a lightweight wrapper around Bun, leveraging Bun's performance characteristics to achieve fast compilation times. Developed as an integral part of the `naka` project, it specifically targets browser automation workflows, optimizing file transformations for that context. A key design principle is its performance, achieved by compiling itself into an executable binary using Bun. This allows for rapid execution without reliance on a globally installed `bun` runtime for the end-user. The bundler offers a "batteries-included" experience with no configuration options, making it ideal for straightforward bundling tasks where customization is not required. For advanced or custom configurations, users are advised to interact with Bun directly rather than through `naka-bundler`. As an early-stage project (v0.0.7), its release cadence is likely tied to the development of the broader `naka` ecosystem.

devops

npm install naka-bundler

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · NAKA-BUNDLER

naka-bundler

devopsjavascriptv0.0.7

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–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

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

nakaBundler

✓ (N/A - CLI tool)

✗ import nakaBundler from 'naka-bundler'

This package is a CLI tool and does not expose a programmatic API for direct import. It should be invoked via `npx naka-bundler` from the command line.

bundle

✓ (N/A - CLI tool)

✗ import { bundle } from 'naka-bundler'

The `naka-bundler` package is designed exclusively for command-line usage. No functions or symbols are exported for programmatic consumption from JavaScript/TypeScript modules.

nakaBundler (CommonJS)

✓ (N/A - CLI tool)

✗ const nakaBundler = require('naka-bundler')

Attempting to `require()` this package will result in a runtime error as it provides no CommonJS exports and is intended solely for CLI execution.

Illustrates bundling 'src/index.ts' and outputting the transpiled result to the 'dist/out' directory using the `naka-bundler` CLI.

npx naka-bundler src/index.ts dist/out # Example with more files or different extensions: npx naka-bundler frontend/main.tsx dist/bundle npx naka-bundler backend/api.js build/server

naka-bundler --version

Debug

Known issues

breakingAs `naka-bundler` is in early development (v0.0.7), expect frequent and unannounced breaking changes in its CLI arguments, behavior, and underlying Bun integration. Pinning exact versions is highly recommended.

fix

Consult the latest GitHub README for current CLI usage. Use tools like `npm install naka-bundler@0.0.7` to pin the version in your projects.

affects: >=0.0.0

gotchaThe `naka-bundler` is explicitly designed with *no configuration options*. Any bundling requirements beyond its opinionated defaults (e.g., custom plugins, different loaders, advanced optimizations) are not supported.

fix

For customizable bundling needs, utilize `bun` directly, which offers extensive configuration, or explore other bundlers like Webpack, Rollup, or Esbuild.

affects: >=0.0.0

gotchaThis package is a pure CLI tool and does not expose any programmatic API for use within JavaScript or TypeScript code. Attempting to `import` or `require` it will lead to errors.

fix

Interact with `naka-bundler` exclusively through your shell or scripts via `npx naka-bundler ...`.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'naka-bundler' or TypeError: naka_bundler_1.default is not a function

Attempting to `import` or `require` `naka-bundler` as a library module.

fix

This package is a CLI. Do not import it; instead, run it directly from your terminal using `npx naka-bundler entry.ts output_dir`.

naka-bundler: command not found

`naka-bundler` is not installed globally, or `npx` cannot locate it in the current environment's `PATH`.

fix

Ensure `npm` is installed and updated. Use `npx naka-bundler ...` to execute, which handles on-demand installation, or install globally with `npm install -g naka-bundler` for frequent direct invocation.

Error: Input file 'path/to/entry.ts' does not exist

The provided entry file path in the CLI command is incorrect, or the specified file does not exist at that location.

fix

Verify the absolute or relative path to your entry TypeScript/JavaScript file. Ensure the file specified actually exists at the provided location.

Upgrade

Version history

0.0.7latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/johno/naka ↗

packagehttps://www.npmjs.com/package/naka-bundler ↗

homepagehttps://johno.com/naka ↗