aria-build

library0.7.4jsnpmunverified

aria-build is a zero-configuration command-line interface (CLI) bundler and packager designed for both TypeScript and JavaScript projects, built upon Rollup. It also exposes a programmatic API for developers needing more granular control over their build processes. The current stable version, 0.7.4, was released approximately three years ago, suggesting the project is no longer actively maintained. Its primary differentiators include a simplified CLI experience, seamless integration with SWC and esbuild for efficient code transformations, and automatic generation of TypeScript declaration files. It aims to streamline common bundling tasks by offering sensible defaults for various module formats like ES and CommonJS. Due to the lack of recent updates, users should be aware that it might not fully support the latest advancements in the JavaScript and TypeScript ecosystems.

devops web-framework data

npm install aria-build

github ↗package ↗

INSTALL

IMPORT

SIG · ARIA-BUILD

aria-build

devopsjavascriptv0.7.4

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.

bundle

✓ import { bundle } from 'aria-build'

✗ const { bundle } = require('aria-build')

The primary function for programmatic bundling. The package is ESM-first; CommonJS `require` might lead to runtime errors or require specific transpilation setups.

clean

✓ import { clean } from 'aria-build'

✗ const { clean } = require('aria-build')

Utility function for cleaning output directories before a build. Follows the same ESM-first import pattern.

TSRollupConfig

✓ import { TSRollupConfig } from 'aria-build'

✗ import type { TSRollupConfig } from 'aria-build'

TypeScript type definition for configuring programmatic builds. While `import type` is generally preferred for types, `aria-build` exports it directly, so a standard named import is shown in examples. Both might work depending on TS config.

This quickstart demonstrates how to programmatically bundle a TypeScript project using `aria-build`'s API, including cleaning the output directory, configuring ES and CJS formats, and enabling esbuild for transformations.

import { bundle, clean } from 'aria-build'; import path from 'node:path'; interface Pkg { dependencies?: Record<string, string>; } (async function() { const pkg: Pkg = (await import(path.resolve(process.cwd(), 'package.json'))).default; const external = [ ...(pkg.dependencies ? Object.keys(pkg.dependencies) : []) ]; const config = { input: './src/index.ts', external, output: [ { file: './dist/aria-build.es.js', format: 'es' }, { file: './dist/aria-build.js', format: 'cjs' } ], tsconfig: { compilerOptions: { declaration: true } } }; console.log('Cleaning dist directory...'); await clean('dist'); console.log('Bundling project...'); await bundle({ config, esbuild: true, write: true }); console.log('Bundling complete!'); })().catch(console.error);

aria-build --version

Debug

Known issues

gotchaThe `aria-build` package appears to be abandoned, with no updates in over three years. This means it might not support newer Node.js versions, modern JavaScript/TypeScript features, or latest versions of its peer dependencies (e.g., TypeScript 5.x).

fix

Consider evaluating alternative, actively maintained bundlers like Rollup directly, esbuild, or Vite. If using `aria-build`, pin all dependencies to versions known to work with 0.7.4.

affects: >=0.7.4

breakingAs a 0.x version package, `aria-build` does not adhere to semantic versioning for breaking changes, meaning any minor release (e.g., 0.7.x to 0.8.x) could introduce breaking changes without a major version increment. Given its abandoned status, this is less about future changes and more about potential instability if you were to downgrade/upgrade to other 0.x versions.

fix

Always pin exact versions (`"aria-build": "0.7.4"`) to ensure consistent builds and thoroughly test after any updates.

affects: >=0.0.0

gotchaThe installation instructions explicitly recommend `tslib@1.13.0`. This older version might conflict with newer TypeScript versions or other project dependencies that expect a more recent `tslib`. Using an incompatible `tslib` can lead to runtime errors or incorrect transpilation.

fix

Ensure your `tslib` version matches the one recommended by `aria-build` (`1.13.0`). If you encounter issues, verify `tslib` compatibility with your project's TypeScript version and other dependencies. You might need to use `resolutions` or `overrides` in your `package.json`.

affects: >=0.7.4

deprecatedThe project's README still displays Travis CI and Coveralls badges, which are often indicative of projects that have not updated their CI/CD pipelines in several years. This reinforces the assessment of the project being unmaintained.

fix

No direct fix for users, but it's a strong indicator to proceed with caution and consider alternatives for long-term projects.

affects: >=0.7.4

Errors

Common errors & fixes

Error: Cannot find module 'typescript' or module 'aria-fs' or module '@swc/core'

One or more of `aria-build`'s peer dependencies are not installed in the project.

fix

Install all required peer dependencies: `npm install --save-dev typescript @swc/core aria-fs`.

TypeError: (0 , aria_build_1.bundle) is not a function

Attempting to use a CommonJS `require()` statement for `aria-build` in a context where it's primarily an ESM package, leading to incorrect module resolution.

fix

Use ES module import syntax: `import { bundle, clean } from 'aria-build';`.

TS2307: Cannot find module 'tslib' or its corresponding type declarations.

The `tslib` package, required by TypeScript for certain helper functions, is missing or an incompatible version is installed.

fix

Install the specific version of `tslib` recommended by `aria-build`: `npm install --save-dev tslib@1.13.0`.

Upgrade

Version history

0.7.4latest on npm

Audit

Dependencies

@swc/corerequiredRequired peer dependency for SWC-based transformations.

aria-fsrequiredRequired peer dependency for file system operations within the build process.

typescriptrequiredRequired peer dependency for TypeScript compilation and type checking.

tslibrequiredRuntime dependency for TypeScript helper functions, specifically version 1.13.0 as recommended.

Agent activity

34 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/aelbore/aria-build ↗

packagehttps://www.npmjs.com/package/aria-build ↗