Description
The freebuff npm package is currently broken. After installing via npm install -g freebuff, the main entry point file is missing, causing the tool to crash.
Steps to Reproduce
Run npm install -g freebuff
Installation claims success: added 7 packages in 838ms
Run freebuff in any directory
See error
Expected Behavior
freebuff should start normally, showing its interactive CLI interface.
Actual Behavior
The command fails with:
text
Error: Out of memory
Root Cause Analysis
The actual error reveals a missing module:
bash
$ node /home/user/.npm-global/lib/node_modules/freebuff/cli/index.js
node:internal/modules/cjs/loader:1505
throw err;
^
Error: Cannot find module '/home/user/.npm-global/lib/node_modules/freebuff/cli/index.js'
at Module._resolveFilename (node:internal/modules/cjs/loader:1502:15)
...
code: 'MODULE_NOT_FOUND',
requireStack: []
}
The directory /freebuff/cli/ does not exist at all in the installed package:
bash
$ ls -la /home/user/.npm-global/lib/node_modules/freebuff/cli/
ls: cannot access '.../freebuff/cli/': No such file or directory
Environment
OS: Arch Linux / CachyOS
Node.js: v26.1.0
npm: (latest)
Package version: freebuff@0.0.107 (the latest on npm registry)
Additional Context
Installing from source (git clone + npm run build) works correctly, indicating the source code is fine
The issue appears to be with the published npm tarball being incomplete
The codebuff package (the paid alternative) installs and runs without issues
The freebuff-1.0.0.tgz file mentioned in the repository does not exist in the source tree
Suggested Fix
The npm publish process needs to be updated to include the compiled cli/ directory and its index.js file. The files field in package.json or the .npmignore file may be excluding necessary build artifacts.
Description
The freebuff npm package is currently broken. After installing via npm install -g freebuff, the main entry point file is missing, causing the tool to crash.
Steps to Reproduce
Run npm install -g freebuff
Installation claims success: added 7 packages in 838ms
Run freebuff in any directory
See error
Expected Behavior
freebuff should start normally, showing its interactive CLI interface.
Actual Behavior
The command fails with:
text
Error: Out of memory
Root Cause Analysis
The actual error reveals a missing module:
bash
$ node /home/user/.npm-global/lib/node_modules/freebuff/cli/index.js
node:internal/modules/cjs/loader:1505
throw err;
^
Error: Cannot find module '/home/user/.npm-global/lib/node_modules/freebuff/cli/index.js'
at Module._resolveFilename (node:internal/modules/cjs/loader:1502:15)
...
code: 'MODULE_NOT_FOUND',
requireStack: []
}
The directory /freebuff/cli/ does not exist at all in the installed package:
bash
$ ls -la /home/user/.npm-global/lib/node_modules/freebuff/cli/
ls: cannot access '.../freebuff/cli/': No such file or directory
Environment
OS: Arch Linux / CachyOS
Node.js: v26.1.0
npm: (latest)
Package version: freebuff@0.0.107 (the latest on npm registry)
Additional Context
Installing from source (git clone + npm run build) works correctly, indicating the source code is fine
The issue appears to be with the published npm tarball being incomplete
The codebuff package (the paid alternative) installs and runs without issues
The freebuff-1.0.0.tgz file mentioned in the repository does not exist in the source tree
Suggested Fix
The npm publish process needs to be updated to include the compiled cli/ directory and its index.js file. The files field in package.json or the .npmignore file may be excluding necessary build artifacts.