Registry / devops / ui-build-compression

ui-build-compression

library1.1.4jsnpmunverified

A Rust-powered build compression tool that creates gzip, brotli, zstd, and deflate compressed file variants alongside originals for production UI deployments. Version 1.1.4 ships TypeScript definitions and supports both programmatic (Rust and Node.js) and CLI usage. Key differentiator: aggressively configured compression settings in Rust for maximum reduction, outperforming pure-JS compressors particularly for brotli and zstd. Suitable for build pipelines of static sites or SPAs.

devops

npm install ui-build-compression

github ↗package ↗

INSTALL

IMPORT

SIG · UI-BUILD-COMPRESSI

ui-build-compression

devopsjavascriptv1.1.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–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

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

compress

✓ import { compress } from 'ui-build-compression'

✗ import compress from 'ui-build-compression'

The package exports a named export, not a default export. Also works with require('ui-build-compression').compress.

compress

✓ const { compress } = require('ui-build-compression')

✗ const compress = require('ui-build-compression')

CommonJS require returns an object; destructure to get the named export.

compress

✓ import { compress } from 'ui-build-compression'

TypeScript usage: same named import. Package includes type definitions.

Compresses all static files in the given directory using gzip, brotli, zstd, and deflate, generating .gz, .br, .zst, .zz alongside originals.

import { compress } from 'ui-build-compression'; import path from 'path'; const buildDir = path.resolve('./dist'); compress(buildDir).then(() => { console.log('Compression complete!'); }).catch(err => { console.error('Compression failed:', err); });

ui-build-compression --version

Debug

Known issues

gotchaThe compress function is asynchronous and returns a Promise; omitting await or .catch() can lead to unhandled promise rejections.

fix

Always use await or attach .catch() to handle errors.

affects: >=1.0

gotchaThe package compresses all files in the directory recursively. Large directories may take significant time due to aggressive compression settings.

fix

Consider using a smaller subdirectory or exclude large binary files if needed. No built-in filter yet.

affects: >=1.0

gotchaThe CLI command 'ui-build-compression' may conflict if a global package with the same name is installed. Always use npx or local scripts.

fix

Prefix with npx: npx ui-build-compression /path/to/dir

affects: >=1.0

Errors

Common errors & fixes

Error: Cannot find module 'ui-build-compression'

Package not installed or missing from node_modules.

fix

Run 'npm install ui-build-compression' or 'yarn add ui-build-compression'.

TypeError: compress is not a function

Default import used instead of named import.

fix

Use named import: import { compress } from 'ui-build-compression'

Error: ENOENT: no such file or directory, stat '/path/to/my/directory'

Provided path does not exist or is relative from wrong working directory.

fix

Provide an absolute path or ensure relative path is correct from process.cwd().

Upgrade

Version history

1.1.4latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/alexfigliolia/ui-build-compression ↗

packagehttps://www.npmjs.com/package/ui-build-compression ↗