Debian...eAudit(3pm)

🌸 Debian::PkgJS::SimpleAudit 💖

okay bestie, so the full manual name on this one is Debian...eAudit(3pm) (it's documented in User Contributed Perl Documentation, iykyk) and it's literally a Perl module that goes and gets security advisories from the NPM registry. tiny module, huge main character energy. let's get into it 🫶

---

✨ NAME ✨

Debian::PkgJS::SimpleAudit — a Perl module that fetches security advisories straight from the NPM registry. no cap, that's the whole personality.

---

🎀 SYNOPSIS 🎀

use Debian::PkgJS::SimpleAudit;

my $audit = advisories('/path/to/nodejs/module');
# OR
my $audit = advisories('@babel/runtime', '0.7.16');

if($audit) {
    print STDERR $audit;
    exit 1;
}

like. look at it. it's giving effortless. you call one function, you check if it gave you anything back, and if it did you scream it to STDERR and bail with exit 1. periodt 💅

---

🦋 DESCRIPTION 🦋

Debian::PkgJS::SimpleAudit hands you exactly one function, and that function's entire job is grabbing security advisories from the NPM registry. one job. does it well. obsessed.

💜 EXPORT 💜

advisories()

bestie this function builds a query to pull up all the NPM security advisories for whatever JS module you point it at, and it returns a string formatted the exact same way as "npm audit" — oh, and it comes back empty if there are no advisories to worry about. so an empty string here is the good ending 🌈

advisories() accepts either one or two arguments:

• advisories('/path/to/module') — it'll sniff out the name and version from the package.json (or package.yaml) sitting in there. let it do the detective work 🔍
• advisories($name,$version) — you hand it the module name and version yourself and skip the snooping.

---

👑 COPYRIGHT AND LICENSE 👑

Copyright Yadd <yadd@debian.org> 💖

This library is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

⚠️ okay real talk for one sec — that all-caps warranty disclaimer is not me being dramatic, that's the actual license text and it genuinely means there's no warranty. respect it. 🙈

On Debian systems, the complete text of version 2 of the GNU General Public License can be found in /usr/share/common-licenses/GPL-2. If it's somehow not there, see http://www.gnu.org/licenses/. 💫

---

and that's the whole page, bestie 💅 written by perl v5.40.1, dated 2026-08-17, filed under Debian...eAudit(3pm) in the User Contributed Perl Documentation section. slay, go audit something. 🎀✨