Registry / devops / tx-webbr-automation

tx-webbr-automation

library0.1.20jsnpmunverified

A build pipeline tool for packaging Node.js applications into single executable binaries using Node.js Single Executable Applications (SEA). Version 0.1.20 compiles TypeScript with tsc, bundles with esbuild, generates a SEA blob, injects it into the Node.js binary, and optionally signs the resulting executable for distribution. Key differentiators: integrates TypeScript compilation, bundling, and SEA injection into one pipeline; supports code signing on Windows. Caution: SEA is experimental and Node-version-dependent; not recommended for production without controlling the Node runtime version.

devops workflow

npm install tx-webbr-automation

package ↗

INSTALL

IMPORT

SIG · TX-WEBBR-AUTOMATIO

tx-webbr-automation

devopsjavascriptv0.1.20

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

auto

✓ import { auto } from 'tx-webbr-automation'

✗ import auto from 'tx-webbr-automation'

Named export, not default.

build

✓ import { build } from 'tx-webbr-automation'

✗ const { build } = require('tx-webbr-automation')

ESM-only package; CommonJS require will fail.

SEAConfig

✓ import type { SEAConfig } from 'tx-webbr-automation'

TypeScript type export, use import type for runtime exclusion.

createSEA

✓ import { createSEA } from 'tx-webbr-automation'

✗ const createSEA = require('tx-webbr-automation').createSEA

Named export only; ESM import required.

Creates an SEA executable from a bundled JavaScript file, using a custom Node binary.

import { build } from 'tx-webbr-automation'; build({ input: './dist/index.js', output: './myapp.exe', nodeExecutable: './node.exe', seaConfig: { main: './sea-main.js', output: './sea.blob', }, sign: false, }).then(() => { console.log('SEA executable created'); }).catch(err => { console.error('Build failed:', err); });

tx-webbr-automation --version

Debug

Known issues

gotchaSEA blobs are tied to the exact Node.js binary version used. Using a different Node version at runtime may crash or fail silently.

fix

Ensure the Node.js executable used for injection matches the target runtime version exactly.

affects: >=0.1.0

gotchaSEA failures may not produce error messages. Set NODE_DEBUG=sea environment variable to see debug output.

fix

Run with NODE_DEBUG=sea to get detailed SEA logs.

affects: >=0.1.0

gotchaWindows may show 'The signature seems corrupted!' if the executable is not signed. Code signing is separate from SEA.

fix

Use signtool on Windows to sign the executable.

affects: >=0.1.0

gotchaThe package is ESM-only. Using require() will throw an error.

fix

Use import syntax or dynamic import() instead.

affects: >=0.1.0

Errors

Common errors & fixes

ERR_REQUIRE_ESM: require() of ES Module

Package is ESM-only; CommonJS require is not supported.

fix

Change to import { ... } from 'tx-webbr-automation' or use dynamic import().

ENOENT: no such file or directory, open '.../sea.blob'

The seaConfig.output path does not exist or is incorrectly specified.

fix

Ensure the directory for the blob output exists, or use an absolute path.

SEA blob injection failed: Invalid argument

The Node.js executable path is incorrect or the binary is not a valid Node executable.

fix

Provide the correct path to the Node.js binary (node.exe on Windows).

Upgrade

Version history

0.1.20latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

44 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/tx-webbr-automation ↗