pagerts 0.2.0 → 1.0.1

package/README.md

@@ -1,39 +1,243 @@
-# README
+# PagerTS
 
-PagerTS is a command line utility that provides the user with a portable tool for transforming an URL into a JSON Object.
+[![CI/CD](https://github.com/akinevz0/pagerts/workflows/CI%2FCD%20Security%20Pipeline/badge.svg)](https://github.com/akinevz0/pagerts/actions)
+[![Security](https://img.shields.io/badge/security-maintained-green.svg)](./SECURITY.md)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
-The output of this command contains all of navigable items one can navigate to within a webpage.
+PagerTS is a secure, modern command-line utility that transforms URLs into structured JSON objects, extracting all navigable items and resources from webpages.
+
+## Features
+
+- 🔒 **Security-First**: Built-in URL validation, rate limiting, and XSS protection
+- 🚀 **Modern TypeScript**: Strict type checking and modern ES2022 syntax
+- ⚡ **Fast**: Efficient parsing with JSDOM and concurrent request handling
+- 🧪 **Well-Tested**: Comprehensive test coverage with Jest
+- 📦 **Easy to Use**: Simple CLI interface with sensible defaults
+
+## Installation
+
+### Global Installation
+
+```bash
+npm install -g pagerts
+pagerts <url>
+```
+
+### Using npx (No Installation Required)
+
+```bash
+npx pagerts <url>
+```
+
+### From Source
+
+```bash
+git clone https://github.com/akinevz0/pagerts.git
+cd pagerts
+npm install
+npm run build
+npm link
+```
 
 ## Usage
 
-To use `pagerts` invoke it in the command line as:
+### Basic Usage
+
+Extract resources from a remote URL:
+
+```bash
+pagerts https://example.com
+```
+
+Extract from multiple URLs:
+
+```bash
+pagerts https://example.com https://example.org
+```
+
+Extract from a local HTML file:
 
 ```bash
-pagerts https://website/page.html
+pagerts file:///path/to/file.html
+```
+
+### Output Format
+
+The output is a JSON object containing:
+
+```json
+{
+  "title": "Page Title",
+  "url": "https://example.com",
+  "resources": [
+    {
+      "name": "Link Text",
+      "url": "https://example.com/page"
+    }
+  ]
+}
 ```
 
-There is also support for loading local system html resources.
+Fields:
+
+- `title`: The page's title extracted from the `<title>` tag
+- `url`: The URL of the page
+- `resources`: Array of resources found on the page (links, meta tags, embeds)
+  - `name`: Readable text or description
+  - `url`: Target URL of the resource
+
+## Security
+
+PagerTS takes security seriously. See [SECURITY.md](./SECURITY.md) for:
+
+- Security features and protections
+- How to report vulnerabilities
+- Best practices for users
+- Security checklist for contributors
 
-## Output
+### Built-in Security Features
 
-The output encodes a dependency list of resources. It is parsed using JSDOM library and returned to the user as an object annotated with fields `title`, `url`, `resources`.
+- ✅ URL validation (only allows `http://`, `https://`, `file://`)
+- ✅ Input sanitization to prevent XSS attacks
+- ✅ Rate limiting (50 requests/minute by default)
+- ✅ Request timeouts to prevent hanging
+- ✅ Maximum URL length enforcement
+- ✅ Suspicious pattern detection
+- ✅ Safe HTML parsing (no script execution)
 
-The last field represents a list of tuples, mapping name of the resource to a url.
+## Development
 
-The name is extracted from the readable text on the page.
+### Prerequisites
 
-## Installing
+- Node.js >= 18.0.0
+- npm >= 9.0.0
 
-The CLI can be installed using npm:
+### Setup
 
 ```bash
-npm i -g pagerts
-pagerts <url>
+# Clone the repository
+git clone https://github.com/akinevz0/pagerts.git
+cd pagerts
+
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev <url>
 ```
 
-Or run from npx:
+### Available Scripts
 
 ```bash
-npx pagerts <url>
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm test:watch
+
+# Build the project
+npm run build
+
+# Lint code
+npm run lint
+
+# Fix linting issues
+npm run lint:fix
+
+# Type check
+npm run type-check
+
+# Format code
+npm run format
+
+# Check formatting
+npm run format:check
+
+# Security audit
+npm run security:audit
+
+# Complete security check (audit + lint)
+npm run security:check
+```
+
+### Project Structure
+
 ```
+pagerts/
+├── src/
+│   ├── main.ts                 # CLI entry point
+│   ├── security.ts             # Security utilities
+│   ├── resource.ts             # Resource types
+│   ├── extractors/             # Content extractors
+│   │   ├── AbstractExtractor.ts
+│   │   ├── PageExtractor.ts
+│   │   ├── ResourceExtractor.ts
+│   │   └── TagExtractor.ts
+│   ├── page/                   # Page fetching
+│   │   ├── Page.ts
+│   │   └── PageFetcher.ts
+│   ├── printers/               # Output formatters
+│   │   ├── AbstractResourcePrinter.ts
+│   │   ├── JSONStylePrinter.ts
+│   │   └── LogStylePrinter.ts
+│   └── __tests__/              # Test files
+├── bin/                        # Built files
+├── .github/workflows/          # CI/CD pipelines
+├── package.json
+├── tsconfig.json
+├── jest.config.js
+├── eslint.config.js
+└── SECURITY.md
+```
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+### Contribution Guidelines
+
+- Write tests for new features
+- Follow the existing code style (enforced by ESLint and Prettier)
+- Update documentation as needed
+- Ensure all tests pass (`npm test`)
+- Run security checks (`npm run security:check`)
+- Follow security best practices (see [SECURITY.md](./SECURITY.md))
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Author
+
+**Kirill kn253 Nevzorov**
+
+## Support
+
+- 🐛 [Report bugs](https://github.com/akinevz0/pagerts/issues)
+- 💡 [Request features](https://github.com/akinevz0/pagerts/issues)
+- 🔒 [Report security issues](./SECURITY.md)
+
+## Changelog
+
+### v0.3.0 (Latest)
+
+- ✨ Added comprehensive security features
+- ✨ Implemented URL validation and sanitization
+- ✨ Added rate limiting
+- ✨ Modernized codebase with TypeScript strict mode
+- ✨ Added ESLint with security plugin
+- ✨ Added comprehensive test suite
+- ✨ Added CI/CD with GitHub Actions
+- ✨ Improved error handling and retry logic
+- 📚 Added security documentation
+
+### v0.2.0
 
+- Initial public release

package/bin/main.js

@@ -1,32 +1,16 @@
 #!/usr/bin/env node
-var de=Object.create;var G=Object.defineProperty;var fe=Object.getOwnPropertyDescriptor;var ge=Object.getOwnPropertyNames;var _e=Object.getPrototypeOf,Oe=Object.prototype.hasOwnProperty;var b=(a,e)=>()=>(e||a((e={exports:{}}).exports,e),e.exports);var be=(a,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of ge(e))!Oe.call(a,n)&&n!==t&&G(a,n,{get:()=>e[n],enumerable:!(i=fe(e,n))||i.enumerable});return a};var Ce=(a,e,t)=>(t=a!=null?de(_e(a)):{},be(e||!a||!a.__esModule?G(t,"default",{value:a,enumerable:!0}):t,a));var A=b(P=>{var x=class extends Error{constructor(e,t,i){super(i),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name,this.code=t,this.exitCode=e,this.nestedError=void 0}},V=class extends x{constructor(e){super(1,"commander.invalidArgument",e),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name}};P.CommanderError=x;P.InvalidArgumentError=V});var w=b(R=>{var{InvalidArgumentError:Ae}=A(),T=class{constructor(e,t){switch(this.description=t||"",this.variadic=!1,this.parseArg=void 0,this.defaultValue=void 0,this.defaultValueDescription=void 0,this.argChoices=void 0,e[0]){case"<":this.required=!0,this._name=e.slice(1,-1);break;case"[":this.required=!1,this._name=e.slice(1,-1);break;default:this.required=!0,this._name=e;break}this._name.length>3&&this._name.slice(-3)==="..."&&(this.variadic=!0,this._name=this._name.slice(0,-3))}name(){return this._name}_concatValue(e,t){return t===this.defaultValue||!Array.isArray(t)?[e]:t.concat(e)}default(e,t){return this.defaultValue=e,this.defaultValueDescription=t,this}argParser(e){return this.parseArg=e,this}choices(e){return this.argChoices=e.slice(),this.parseArg=(t,i)=>{if(!this.argChoices.includes(t))throw new Ae(`Allowed choices are ${this.argChoices.join(", ")}.`);return this.variadic?this._concatValue(t,i):t},this}argRequired(){return this.required=!0,this}argOptional(){return this.required=!1,this}};function ye(a){let e=a.name()+(a.variadic===!0?"...":"");return a.required?"<"+e+">":"["+e+"]"}R.Argument=T;R.humanReadableArgName=ye});var M=b(J=>{var{humanReadableArgName:xe}=w(),D=class{constructor(){this.helpWidth=void 0,this.sortSubcommands=!1,this.sortOptions=!1,this.showGlobalOptions=!1}visibleCommands(e){let t=e.commands.filter(n=>!n._hidden),i=e._getHelpCommand();return i&&!i._hidden&&t.push(i),this.sortSubcommands&&t.sort((n,s)=>n.name().localeCompare(s.name())),t}compareOptions(e,t){let i=n=>n.short?n.short.replace(/^-/,""):n.long.replace(/^--/,"");return i(e).localeCompare(i(t))}visibleOptions(e){let t=e.options.filter(n=>!n.hidden),i=e._getHelpOption();if(i&&!i.hidden){let n=i.short&&e._findOption(i.short),s=i.long&&e._findOption(i.long);!n&&!s?t.push(i):i.long&&!s?t.push(e.createOption(i.long,i.description)):i.short&&!n&&t.push(e.createOption(i.short,i.description))}return this.sortOptions&&t.sort(this.compareOptions),t}visibleGlobalOptions(e){if(!this.showGlobalOptions)return[];let t=[];for(let i=e.parent;i;i=i.parent){let n=i.options.filter(s=>!s.hidden);t.push(...n)}return this.sortOptions&&t.sort(this.compareOptions),t}visibleArguments(e){return e._argsDescription&&e.registeredArguments.forEach(t=>{t.description=t.description||e._argsDescription[t.name()]||""}),e.registeredArguments.find(t=>t.description)?e.registeredArguments:[]}subcommandTerm(e){let t=e.registeredArguments.map(i=>xe(i)).join(" ");return e._name+(e._aliases[0]?"|"+e._aliases[0]:"")+(e.options.length?" [options]":"")+(t?" "+t:"")}optionTerm(e){return e.flags}argumentTerm(e){return e.name()}longestSubcommandTermLength(e,t){return t.visibleCommands(e).reduce((i,n)=>Math.max(i,t.subcommandTerm(n).length),0)}longestOptionTermLength(e,t){return t.visibleOptions(e).reduce((i,n)=>Math.max(i,t.optionTerm(n).length),0)}longestGlobalOptionTermLength(e,t){return t.visibleGlobalOptions(e).reduce((i,n)=>Math.max(i,t.optionTerm(n).length),0)}longestArgumentTermLength(e,t){return t.visibleArguments(e).reduce((i,n)=>Math.max(i,t.argumentTerm(n).length),0)}commandUsage(e){let t=e._name;e._aliases[0]&&(t=t+"|"+e._aliases[0]);let i="";for(let n=e.parent;n;n=n.parent)i=n.name()+" "+i;return i+t+" "+e.usage()}commandDescription(e){return e.description()}subcommandDescription(e){return e.summary()||e.description()}optionDescription(e){let t=[];return e.argChoices&&t.push(`choices: ${e.argChoices.map(i=>JSON.stringify(i)).join(", ")}`),e.defaultValue!==void 0&&(e.required||e.optional||e.isBoolean()&&typeof e.defaultValue=="boolean")&&t.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),e.presetArg!==void 0&&e.optional&&t.push(`preset: ${JSON.stringify(e.presetArg)}`),e.envVar!==void 0&&t.push(`env: ${e.envVar}`),t.length>0?`${e.description} (${t.join(", ")})`:e.description}argumentDescription(e){let t=[];if(e.argChoices&&t.push(`choices: ${e.argChoices.map(i=>JSON.stringify(i)).join(", ")}`),e.defaultValue!==void 0&&t.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),t.length>0){let i=`(${t.join(", ")})`;return e.description?`${e.description} ${i}`:i}return e.description}formatHelp(e,t){let i=t.padWidth(e,t),n=t.helpWidth||80,s=2,r=2;function u(p,_){if(_){let H=`${p.padEnd(i+r)}${_}`;return t.wrap(H,n-s,i+r)}return p}function o(p){return p.join(`
-`).replace(/^/gm," ".repeat(s))}let l=[`Usage: ${t.commandUsage(e)}`,""],h=t.commandDescription(e);h.length>0&&(l=l.concat([t.wrap(h,n,0),""]));let c=t.visibleArguments(e).map(p=>u(t.argumentTerm(p),t.argumentDescription(p)));c.length>0&&(l=l.concat(["Arguments:",o(c),""]));let d=t.visibleOptions(e).map(p=>u(t.optionTerm(p),t.optionDescription(p)));if(d.length>0&&(l=l.concat(["Options:",o(d),""])),this.showGlobalOptions){let p=t.visibleGlobalOptions(e).map(_=>u(t.optionTerm(_),t.optionDescription(_)));p.length>0&&(l=l.concat(["Global Options:",o(p),""]))}let O=t.visibleCommands(e).map(p=>u(t.subcommandTerm(p),t.subcommandDescription(p)));return O.length>0&&(l=l.concat(["Commands:",o(O),""])),l.join(`
-`)}padWidth(e,t){return Math.max(t.longestOptionTermLength(e,t),t.longestGlobalOptionTermLength(e,t),t.longestSubcommandTermLength(e,t),t.longestArgumentTermLength(e,t))}wrap(e,t,i,n=40){let s=" \\f\\t\\v\xA0\u1680\u2000-\u200A\u202F\u205F\u3000\uFEFF",r=new RegExp(`[\\n][${s}]+`);if(e.match(r))return e;let u=t-i;if(u<n)return e;let o=e.slice(0,i),l=e.slice(i).replace(`\r
-`,`
-`),h=" ".repeat(i),d="\\s\u200B",O=new RegExp(`
-|.{1,${u-1}}([${d}]|$)|[^${d}]+?([${d}]|$)`,"g"),p=l.match(O)||[];return o+p.map((_,H)=>_===`
-`?"":(H>0?h:"")+_.trimEnd()).join(`
-`)}};J.Help=D});var I=b(q=>{var{InvalidArgumentError:we}=A(),N=class{constructor(e,t){this.flags=e,this.description=t||"",this.required=e.includes("<"),this.optional=e.includes("["),this.variadic=/\w\.\.\.[>\]]$/.test(e),this.mandatory=!1;let i=ve(e);this.short=i.shortFlag,this.long=i.longFlag,this.negate=!1,this.long&&(this.negate=this.long.startsWith("--no-")),this.defaultValue=void 0,this.defaultValueDescription=void 0,this.presetArg=void 0,this.envVar=void 0,this.parseArg=void 0,this.hidden=!1,this.argChoices=void 0,this.conflictsWith=[],this.implied=void 0}default(e,t){return this.defaultValue=e,this.defaultValueDescription=t,this}preset(e){return this.presetArg=e,this}conflicts(e){return this.conflictsWith=this.conflictsWith.concat(e),this}implies(e){let t=e;return typeof e=="string"&&(t={[e]:!0}),this.implied=Object.assign(this.implied||{},t),this}env(e){return this.envVar=e,this}argParser(e){return this.parseArg=e,this}makeOptionMandatory(e=!0){return this.mandatory=!!e,this}hideHelp(e=!0){return this.hidden=!!e,this}_concatValue(e,t){return t===this.defaultValue||!Array.isArray(t)?[e]:t.concat(e)}choices(e){return this.argChoices=e.slice(),this.parseArg=(t,i)=>{if(!this.argChoices.includes(t))throw new we(`Allowed choices are ${this.argChoices.join(", ")}.`);return this.variadic?this._concatValue(t,i):t},this}name(){return this.long?this.long.replace(/^--/,""):this.short.replace(/^-/,"")}attributeName(){return Ee(this.name().replace(/^no-/,""))}is(e){return this.short===e||this.long===e}isBoolean(){return!this.required&&!this.optional&&!this.negate}},F=class{constructor(e){this.positiveOptions=new Map,this.negativeOptions=new Map,this.dualOptions=new Set,e.forEach(t=>{t.negate?this.negativeOptions.set(t.attributeName(),t):this.positiveOptions.set(t.attributeName(),t)}),this.negativeOptions.forEach((t,i)=>{this.positiveOptions.has(i)&&this.dualOptions.add(i)})}valueFromOption(e,t){let i=t.attributeName();if(!this.dualOptions.has(i))return!0;let n=this.negativeOptions.get(i).presetArg,s=n!==void 0?n:!1;return t.negate===(s===e)}};function Ee(a){return a.split("-").reduce((e,t)=>e+t[0].toUpperCase()+t.slice(1))}function ve(a){let e,t,i=a.split(/[ |,]+/);return i.length>1&&!/^[[<]/.test(i[1])&&(e=i.shift()),t=i.shift(),!e&&/^-[^-]$/.test(t)&&(e=t,t=void 0),{shortFlag:e,longFlag:t}}q.Option=N;q.DualOptions=F});var z=b(Y=>{function $e(a,e){if(Math.abs(a.length-e.length)>3)return Math.max(a.length,e.length);let t=[];for(let i=0;i<=a.length;i++)t[i]=[i];for(let i=0;i<=e.length;i++)t[0][i]=i;for(let i=1;i<=e.length;i++)for(let n=1;n<=a.length;n++){let s=1;a[n-1]===e[i-1]?s=0:s=1,t[n][i]=Math.min(t[n-1][i]+1,t[n][i-1]+1,t[n-1][i-1]+s),n>1&&i>1&&a[n-1]===e[i-2]&&a[n-2]===e[i-1]&&(t[n][i]=Math.min(t[n][i],t[n-2][i-2]+1))}return t[a.length][e.length]}function Se(a,e){if(!e||e.length===0)return"";e=Array.from(new Set(e));let t=a.startsWith("--");t&&(a=a.slice(2),e=e.map(r=>r.slice(2)));let i=[],n=3,s=.4;return e.forEach(r=>{if(r.length<=1)return;let u=$e(a,r),o=Math.max(a.length,r.length);(o-u)/o>s&&(u<n?(n=u,i=[r]):u===n&&i.push(r))}),i.sort((r,u)=>r.localeCompare(u)),t&&(i=i.map(r=>`--${r}`)),i.length>1?`
-(Did you mean one of ${i.join(", ")}?)`:i.length===1?`
-(Did you mean ${i[0]}?)`:""}Y.suggestSimilar=Se});var te=b(ee=>{var ke=require("node:events").EventEmitter,j=require("node:child_process"),g=require("node:path"),L=require("node:fs"),m=require("node:process"),{Argument:He,humanReadableArgName:Ve}=w(),{CommanderError:W}=A(),{Help:Pe}=M(),{Option:Q,DualOptions:Te}=I(),{suggestSimilar:X}=z(),K=class a extends ke{constructor(e){super(),this.commands=[],this.options=[],this.parent=null,this._allowUnknownOption=!1,this._allowExcessArguments=!0,this.registeredArguments=[],this._args=this.registeredArguments,this.args=[],this.rawArgs=[],this.processedArgs=[],this._scriptPath=null,this._name=e||"",this._optionValues={},this._optionValueSources={},this._storeOptionsAsProperties=!1,this._actionHandler=null,this._executableHandler=!1,this._executableFile=null,this._executableDir=null,this._defaultCommandName=null,this._exitCallback=null,this._aliases=[],this._combineFlagAndOptionalValue=!0,this._description="",this._summary="",this._argsDescription=void 0,this._enablePositionalOptions=!1,this._passThroughOptions=!1,this._lifeCycleHooks={},this._showHelpAfterError=!1,this._showSuggestionAfterError=!0,this._outputConfiguration={writeOut:t=>m.stdout.write(t),writeErr:t=>m.stderr.write(t),getOutHelpWidth:()=>m.stdout.isTTY?m.stdout.columns:void 0,getErrHelpWidth:()=>m.stderr.isTTY?m.stderr.columns:void 0,outputError:(t,i)=>i(t)},this._hidden=!1,this._helpOption=void 0,this._addImplicitHelpCommand=void 0,this._helpCommand=void 0,this._helpConfiguration={}}copyInheritedSettings(e){return this._outputConfiguration=e._outputConfiguration,this._helpOption=e._helpOption,this._helpCommand=e._helpCommand,this._helpConfiguration=e._helpConfiguration,this._exitCallback=e._exitCallback,this._storeOptionsAsProperties=e._storeOptionsAsProperties,this._combineFlagAndOptionalValue=e._combineFlagAndOptionalValue,this._allowExcessArguments=e._allowExcessArguments,this._enablePositionalOptions=e._enablePositionalOptions,this._showHelpAfterError=e._showHelpAfterError,this._showSuggestionAfterError=e._showSuggestionAfterError,this}_getCommandAndAncestors(){let e=[];for(let t=this;t;t=t.parent)e.push(t);return e}command(e,t,i){let n=t,s=i;typeof n=="object"&&n!==null&&(s=n,n=null),s=s||{};let[,r,u]=e.match(/([^ ]+) *(.*)/),o=this.createCommand(r);return n&&(o.description(n),o._executableHandler=!0),s.isDefault&&(this._defaultCommandName=o._name),o._hidden=!!(s.noHelp||s.hidden),o._executableFile=s.executableFile||null,u&&o.arguments(u),this._registerCommand(o),o.parent=this,o.copyInheritedSettings(this),n?this:o}createCommand(e){return new a(e)}createHelp(){return Object.assign(new Pe,this.configureHelp())}configureHelp(e){return e===void 0?this._helpConfiguration:(this._helpConfiguration=e,this)}configureOutput(e){return e===void 0?this._outputConfiguration:(Object.assign(this._outputConfiguration,e),this)}showHelpAfterError(e=!0){return typeof e!="string"&&(e=!!e),this._showHelpAfterError=e,this}showSuggestionAfterError(e=!0){return this._showSuggestionAfterError=!!e,this}addCommand(e,t){if(!e._name)throw new Error(`Command passed to .addCommand() must have a name
-- specify the name in Command constructor or using .name()`);return t=t||{},t.isDefault&&(this._defaultCommandName=e._name),(t.noHelp||t.hidden)&&(e._hidden=!0),this._registerCommand(e),e.parent=this,e._checkForBrokenPassThrough(),this}createArgument(e,t){return new He(e,t)}argument(e,t,i,n){let s=this.createArgument(e,t);return typeof i=="function"?s.default(n).argParser(i):s.default(i),this.addArgument(s),this}arguments(e){return e.trim().split(/ +/).forEach(t=>{this.argument(t)}),this}addArgument(e){let t=this.registeredArguments.slice(-1)[0];if(t&&t.variadic)throw new Error(`only the last argument can be variadic '${t.name()}'`);if(e.required&&e.defaultValue!==void 0&&e.parseArg===void 0)throw new Error(`a default value for a required argument is never used: '${e.name()}'`);return this.registeredArguments.push(e),this}helpCommand(e,t){if(typeof e=="boolean")return this._addImplicitHelpCommand=e,this;e=e??"help [command]";let[,i,n]=e.match(/([^ ]+) *(.*)/),s=t??"display help for command",r=this.createCommand(i);return r.helpOption(!1),n&&r.arguments(n),s&&r.description(s),this._addImplicitHelpCommand=!0,this._helpCommand=r,this}addHelpCommand(e,t){return typeof e!="object"?(this.helpCommand(e,t),this):(this._addImplicitHelpCommand=!0,this._helpCommand=e,this)}_getHelpCommand(){return this._addImplicitHelpCommand??(this.commands.length&&!this._actionHandler&&!this._findCommand("help"))?(this._helpCommand===void 0&&this.helpCommand(void 0,void 0),this._helpCommand):null}hook(e,t){let i=["preSubcommand","preAction","postAction"];if(!i.includes(e))throw new Error(`Unexpected value for event passed to hook : '${e}'.
-Expecting one of '${i.join("', '")}'`);return this._lifeCycleHooks[e]?this._lifeCycleHooks[e].push(t):this._lifeCycleHooks[e]=[t],this}exitOverride(e){return e?this._exitCallback=e:this._exitCallback=t=>{if(t.code!=="commander.executeSubCommandAsync")throw t},this}_exit(e,t,i){this._exitCallback&&this._exitCallback(new W(e,t,i)),m.exit(e)}action(e){let t=i=>{let n=this.registeredArguments.length,s=i.slice(0,n);return this._storeOptionsAsProperties?s[n]=this:s[n]=this.opts(),s.push(this),e.apply(this,s)};return this._actionHandler=t,this}createOption(e,t){return new Q(e,t)}_callParseArg(e,t,i,n){try{return e.parseArg(t,i)}catch(s){if(s.code==="commander.invalidArgument"){let r=`${n} ${s.message}`;this.error(r,{exitCode:s.exitCode,code:s.code})}throw s}}_registerOption(e){let t=e.short&&this._findOption(e.short)||e.long&&this._findOption(e.long);if(t){let i=e.long&&this._findOption(e.long)?e.long:e.short;throw new Error(`Cannot add option '${e.flags}'${this._name&&` to command '${this._name}'`} due to conflicting flag '${i}'
--  already used by option '${t.flags}'`)}this.options.push(e)}_registerCommand(e){let t=n=>[n.name()].concat(n.aliases()),i=t(e).find(n=>this._findCommand(n));if(i){let n=t(this._findCommand(i)).join("|"),s=t(e).join("|");throw new Error(`cannot add command '${s}' as already have command '${n}'`)}this.commands.push(e)}addOption(e){this._registerOption(e);let t=e.name(),i=e.attributeName();if(e.negate){let s=e.long.replace(/^--no-/,"--");this._findOption(s)||this.setOptionValueWithSource(i,e.defaultValue===void 0?!0:e.defaultValue,"default")}else e.defaultValue!==void 0&&this.setOptionValueWithSource(i,e.defaultValue,"default");let n=(s,r,u)=>{s==null&&e.presetArg!==void 0&&(s=e.presetArg);let o=this.getOptionValue(i);s!==null&&e.parseArg?s=this._callParseArg(e,s,o,r):s!==null&&e.variadic&&(s=e._concatValue(s,o)),s==null&&(e.negate?s=!1:e.isBoolean()||e.optional?s=!0:s=""),this.setOptionValueWithSource(i,s,u)};return this.on("option:"+t,s=>{let r=`error: option '${e.flags}' argument '${s}' is invalid.`;n(s,r,"cli")}),e.envVar&&this.on("optionEnv:"+t,s=>{let r=`error: option '${e.flags}' value '${s}' from env '${e.envVar}' is invalid.`;n(s,r,"env")}),this}_optionEx(e,t,i,n,s){if(typeof t=="object"&&t instanceof Q)throw new Error("To add an Option object use addOption() instead of option() or requiredOption()");let r=this.createOption(t,i);if(r.makeOptionMandatory(!!e.mandatory),typeof n=="function")r.default(s).argParser(n);else if(n instanceof RegExp){let u=n;n=(o,l)=>{let h=u.exec(o);return h?h[0]:l},r.default(s).argParser(n)}else r.default(n);return this.addOption(r)}option(e,t,i,n){return this._optionEx({},e,t,i,n)}requiredOption(e,t,i,n){return this._optionEx({mandatory:!0},e,t,i,n)}combineFlagAndOptionalValue(e=!0){return this._combineFlagAndOptionalValue=!!e,this}allowUnknownOption(e=!0){return this._allowUnknownOption=!!e,this}allowExcessArguments(e=!0){return this._allowExcessArguments=!!e,this}enablePositionalOptions(e=!0){return this._enablePositionalOptions=!!e,this}passThroughOptions(e=!0){return this._passThroughOptions=!!e,this._checkForBrokenPassThrough(),this}_checkForBrokenPassThrough(){if(this.parent&&this._passThroughOptions&&!this.parent._enablePositionalOptions)throw new Error(`passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`)}storeOptionsAsProperties(e=!0){if(this.options.length)throw new Error("call .storeOptionsAsProperties() before adding options");if(Object.keys(this._optionValues).length)throw new Error("call .storeOptionsAsProperties() before setting option values");return this._storeOptionsAsProperties=!!e,this}getOptionValue(e){return this._storeOptionsAsProperties?this[e]:this._optionValues[e]}setOptionValue(e,t){return this.setOptionValueWithSource(e,t,void 0)}setOptionValueWithSource(e,t,i){return this._storeOptionsAsProperties?this[e]=t:this._optionValues[e]=t,this._optionValueSources[e]=i,this}getOptionValueSource(e){return this._optionValueSources[e]}getOptionValueSourceWithGlobals(e){let t;return this._getCommandAndAncestors().forEach(i=>{i.getOptionValueSource(e)!==void 0&&(t=i.getOptionValueSource(e))}),t}_prepareUserArgs(e,t){if(e!==void 0&&!Array.isArray(e))throw new Error("first parameter to parse must be array or undefined");if(t=t||{},e===void 0&&t.from===void 0){m.versions?.electron&&(t.from="electron");let n=m.execArgv??[];(n.includes("-e")||n.includes("--eval")||n.includes("-p")||n.includes("--print"))&&(t.from="eval")}e===void 0&&(e=m.argv),this.rawArgs=e.slice();let i;switch(t.from){case void 0:case"node":this._scriptPath=e[1],i=e.slice(2);break;case"electron":m.defaultApp?(this._scriptPath=e[1],i=e.slice(2)):i=e.slice(1);break;case"user":i=e.slice(0);break;case"eval":i=e.slice(1);break;default:throw new Error(`unexpected parse option { from: '${t.from}' }`)}return!this._name&&this._scriptPath&&this.nameFromFilename(this._scriptPath),this._name=this._name||"program",i}parse(e,t){let i=this._prepareUserArgs(e,t);return this._parseCommand([],i),this}async parseAsync(e,t){let i=this._prepareUserArgs(e,t);return await this._parseCommand([],i),this}_executeSubCommand(e,t){t=t.slice();let i=!1,n=[".js",".ts",".tsx",".mjs",".cjs"];function s(h,c){let d=g.resolve(h,c);if(L.existsSync(d))return d;if(n.includes(g.extname(c)))return;let O=n.find(p=>L.existsSync(`${d}${p}`));if(O)return`${d}${O}`}this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let r=e._executableFile||`${this._name}-${e._name}`,u=this._executableDir||"";if(this._scriptPath){let h;try{h=L.realpathSync(this._scriptPath)}catch{h=this._scriptPath}u=g.resolve(g.dirname(h),u)}if(u){let h=s(u,r);if(!h&&!e._executableFile&&this._scriptPath){let c=g.basename(this._scriptPath,g.extname(this._scriptPath));c!==this._name&&(h=s(u,`${c}-${e._name}`))}r=h||r}i=n.includes(g.extname(r));let o;m.platform!=="win32"?i?(t.unshift(r),t=Z(m.execArgv).concat(t),o=j.spawn(m.argv[0],t,{stdio:"inherit"})):o=j.spawn(r,t,{stdio:"inherit"}):(t.unshift(r),t=Z(m.execArgv).concat(t),o=j.spawn(m.execPath,t,{stdio:"inherit"})),o.killed||["SIGUSR1","SIGUSR2","SIGTERM","SIGINT","SIGHUP"].forEach(c=>{m.on(c,()=>{o.killed===!1&&o.exitCode===null&&o.kill(c)})});let l=this._exitCallback;o.on("close",h=>{h=h??1,l?l(new W(h,"commander.executeSubCommandAsync","(close)")):m.exit(h)}),o.on("error",h=>{if(h.code==="ENOENT"){let c=u?`searched for local subcommand relative to directory '${u}'`:"no directory for search for local subcommand, use .executableDir() to supply a custom directory",d=`'${r}' does not exist
- - if '${e._name}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
- - if the default executable name is not suitable, use the executableFile option to supply a custom name or path
- - ${c}`;throw new Error(d)}else if(h.code==="EACCES")throw new Error(`'${r}' not executable`);if(!l)m.exit(1);else{let c=new W(1,"commander.executeSubCommandAsync","(error)");c.nestedError=h,l(c)}}),this.runningCommand=o}_dispatchSubcommand(e,t,i){let n=this._findCommand(e);n||this.help({error:!0});let s;return s=this._chainOrCallSubCommandHook(s,n,"preSubcommand"),s=this._chainOrCall(s,()=>{if(n._executableHandler)this._executeSubCommand(n,t.concat(i));else return n._parseCommand(t,i)}),s}_dispatchHelpCommand(e){e||this.help();let t=this._findCommand(e);return t&&!t._executableHandler&&t.help(),this._dispatchSubcommand(e,[],[this._getHelpOption()?.long??this._getHelpOption()?.short??"--help"])}_checkNumberOfArguments(){this.registeredArguments.forEach((e,t)=>{e.required&&this.args[t]==null&&this.missingArgument(e.name())}),!(this.registeredArguments.length>0&&this.registeredArguments[this.registeredArguments.length-1].variadic)&&this.args.length>this.registeredArguments.length&&this._excessArguments(this.args)}_processArguments(){let e=(i,n,s)=>{let r=n;if(n!==null&&i.parseArg){let u=`error: command-argument value '${n}' is invalid for argument '${i.name()}'.`;r=this._callParseArg(i,n,s,u)}return r};this._checkNumberOfArguments();let t=[];this.registeredArguments.forEach((i,n)=>{let s=i.defaultValue;i.variadic?n<this.args.length?(s=this.args.slice(n),i.parseArg&&(s=s.reduce((r,u)=>e(i,u,r),i.defaultValue))):s===void 0&&(s=[]):n<this.args.length&&(s=this.args[n],i.parseArg&&(s=e(i,s,i.defaultValue))),t[n]=s}),this.processedArgs=t}_chainOrCall(e,t){return e&&e.then&&typeof e.then=="function"?e.then(()=>t()):t()}_chainOrCallHooks(e,t){let i=e,n=[];return this._getCommandAndAncestors().reverse().filter(s=>s._lifeCycleHooks[t]!==void 0).forEach(s=>{s._lifeCycleHooks[t].forEach(r=>{n.push({hookedCommand:s,callback:r})})}),t==="postAction"&&n.reverse(),n.forEach(s=>{i=this._chainOrCall(i,()=>s.callback(s.hookedCommand,this))}),i}_chainOrCallSubCommandHook(e,t,i){let n=e;return this._lifeCycleHooks[i]!==void 0&&this._lifeCycleHooks[i].forEach(s=>{n=this._chainOrCall(n,()=>s(this,t))}),n}_parseCommand(e,t){let i=this.parseOptions(t);if(this._parseOptionsEnv(),this._parseOptionsImplied(),e=e.concat(i.operands),t=i.unknown,this.args=e.concat(t),e&&this._findCommand(e[0]))return this._dispatchSubcommand(e[0],e.slice(1),t);if(this._getHelpCommand()&&e[0]===this._getHelpCommand().name())return this._dispatchHelpCommand(e[1]);if(this._defaultCommandName)return this._outputHelpIfRequested(t),this._dispatchSubcommand(this._defaultCommandName,e,t);this.commands.length&&this.args.length===0&&!this._actionHandler&&!this._defaultCommandName&&this.help({error:!0}),this._outputHelpIfRequested(i.unknown),this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let n=()=>{i.unknown.length>0&&this.unknownOption(i.unknown[0])},s=`command:${this.name()}`;if(this._actionHandler){n(),this._processArguments();let r;return r=this._chainOrCallHooks(r,"preAction"),r=this._chainOrCall(r,()=>this._actionHandler(this.processedArgs)),this.parent&&(r=this._chainOrCall(r,()=>{this.parent.emit(s,e,t)})),r=this._chainOrCallHooks(r,"postAction"),r}if(this.parent&&this.parent.listenerCount(s))n(),this._processArguments(),this.parent.emit(s,e,t);else if(e.length){if(this._findCommand("*"))return this._dispatchSubcommand("*",e,t);this.listenerCount("command:*")?this.emit("command:*",e,t):this.commands.length?this.unknownCommand():(n(),this._processArguments())}else this.commands.length?(n(),this.help({error:!0})):(n(),this._processArguments())}_findCommand(e){if(e)return this.commands.find(t=>t._name===e||t._aliases.includes(e))}_findOption(e){return this.options.find(t=>t.is(e))}_checkForMissingMandatoryOptions(){this._getCommandAndAncestors().forEach(e=>{e.options.forEach(t=>{t.mandatory&&e.getOptionValue(t.attributeName())===void 0&&e.missingMandatoryOptionValue(t)})})}_checkForConflictingLocalOptions(){let e=this.options.filter(i=>{let n=i.attributeName();return this.getOptionValue(n)===void 0?!1:this.getOptionValueSource(n)!=="default"});e.filter(i=>i.conflictsWith.length>0).forEach(i=>{let n=e.find(s=>i.conflictsWith.includes(s.attributeName()));n&&this._conflictingOption(i,n)})}_checkForConflictingOptions(){this._getCommandAndAncestors().forEach(e=>{e._checkForConflictingLocalOptions()})}parseOptions(e){let t=[],i=[],n=t,s=e.slice();function r(o){return o.length>1&&o[0]==="-"}let u=null;for(;s.length;){let o=s.shift();if(o==="--"){n===i&&n.push(o),n.push(...s);break}if(u&&!r(o)){this.emit(`option:${u.name()}`,o);continue}if(u=null,r(o)){let l=this._findOption(o);if(l){if(l.required){let h=s.shift();h===void 0&&this.optionMissingArgument(l),this.emit(`option:${l.name()}`,h)}else if(l.optional){let h=null;s.length>0&&!r(s[0])&&(h=s.shift()),this.emit(`option:${l.name()}`,h)}else this.emit(`option:${l.name()}`);u=l.variadic?l:null;continue}}if(o.length>2&&o[0]==="-"&&o[1]!=="-"){let l=this._findOption(`-${o[1]}`);if(l){l.required||l.optional&&this._combineFlagAndOptionalValue?this.emit(`option:${l.name()}`,o.slice(2)):(this.emit(`option:${l.name()}`),s.unshift(`-${o.slice(2)}`));continue}}if(/^--[^=]+=/.test(o)){let l=o.indexOf("="),h=this._findOption(o.slice(0,l));if(h&&(h.required||h.optional)){this.emit(`option:${h.name()}`,o.slice(l+1));continue}}if(r(o)&&(n=i),(this._enablePositionalOptions||this._passThroughOptions)&&t.length===0&&i.length===0){if(this._findCommand(o)){t.push(o),s.length>0&&i.push(...s);break}else if(this._getHelpCommand()&&o===this._getHelpCommand().name()){t.push(o),s.length>0&&t.push(...s);break}else if(this._defaultCommandName){i.push(o),s.length>0&&i.push(...s);break}}if(this._passThroughOptions){n.push(o),s.length>0&&n.push(...s);break}n.push(o)}return{operands:t,unknown:i}}opts(){if(this._storeOptionsAsProperties){let e={},t=this.options.length;for(let i=0;i<t;i++){let n=this.options[i].attributeName();e[n]=n===this._versionOptionName?this._version:this[n]}return e}return this._optionValues}optsWithGlobals(){return this._getCommandAndAncestors().reduce((e,t)=>Object.assign(e,t.opts()),{})}error(e,t){this._outputConfiguration.outputError(`${e}
-`,this._outputConfiguration.writeErr),typeof this._showHelpAfterError=="string"?this._outputConfiguration.writeErr(`${this._showHelpAfterError}
-`):this._showHelpAfterError&&(this._outputConfiguration.writeErr(`
-`),this.outputHelp({error:!0}));let i=t||{},n=i.exitCode||1,s=i.code||"commander.error";this._exit(n,s,e)}_parseOptionsEnv(){this.options.forEach(e=>{if(e.envVar&&e.envVar in m.env){let t=e.attributeName();(this.getOptionValue(t)===void 0||["default","config","env"].includes(this.getOptionValueSource(t)))&&(e.required||e.optional?this.emit(`optionEnv:${e.name()}`,m.env[e.envVar]):this.emit(`optionEnv:${e.name()}`))}})}_parseOptionsImplied(){let e=new Te(this.options),t=i=>this.getOptionValue(i)!==void 0&&!["default","implied"].includes(this.getOptionValueSource(i));this.options.filter(i=>i.implied!==void 0&&t(i.attributeName())&&e.valueFromOption(this.getOptionValue(i.attributeName()),i)).forEach(i=>{Object.keys(i.implied).filter(n=>!t(n)).forEach(n=>{this.setOptionValueWithSource(n,i.implied[n],"implied")})})}missingArgument(e){let t=`error: missing required argument '${e}'`;this.error(t,{code:"commander.missingArgument"})}optionMissingArgument(e){let t=`error: option '${e.flags}' argument missing`;this.error(t,{code:"commander.optionMissingArgument"})}missingMandatoryOptionValue(e){let t=`error: required option '${e.flags}' not specified`;this.error(t,{code:"commander.missingMandatoryOptionValue"})}_conflictingOption(e,t){let i=r=>{let u=r.attributeName(),o=this.getOptionValue(u),l=this.options.find(c=>c.negate&&u===c.attributeName()),h=this.options.find(c=>!c.negate&&u===c.attributeName());return l&&(l.presetArg===void 0&&o===!1||l.presetArg!==void 0&&o===l.presetArg)?l:h||r},n=r=>{let u=i(r),o=u.attributeName();return this.getOptionValueSource(o)==="env"?`environment variable '${u.envVar}'`:`option '${u.flags}'`},s=`error: ${n(e)} cannot be used with ${n(t)}`;this.error(s,{code:"commander.conflictingOption"})}unknownOption(e){if(this._allowUnknownOption)return;let t="";if(e.startsWith("--")&&this._showSuggestionAfterError){let n=[],s=this;do{let r=s.createHelp().visibleOptions(s).filter(u=>u.long).map(u=>u.long);n=n.concat(r),s=s.parent}while(s&&!s._enablePositionalOptions);t=X(e,n)}let i=`error: unknown option '${e}'${t}`;this.error(i,{code:"commander.unknownOption"})}_excessArguments(e){if(this._allowExcessArguments)return;let t=this.registeredArguments.length,i=t===1?"":"s",s=`error: too many arguments${this.parent?` for '${this.name()}'`:""}. Expected ${t} argument${i} but got ${e.length}.`;this.error(s,{code:"commander.excessArguments"})}unknownCommand(){let e=this.args[0],t="";if(this._showSuggestionAfterError){let n=[];this.createHelp().visibleCommands(this).forEach(s=>{n.push(s.name()),s.alias()&&n.push(s.alias())}),t=X(e,n)}let i=`error: unknown command '${e}'${t}`;this.error(i,{code:"commander.unknownCommand"})}version(e,t,i){if(e===void 0)return this._version;this._version=e,t=t||"-V, --version",i=i||"output the version number";let n=this.createOption(t,i);return this._versionOptionName=n.attributeName(),this._registerOption(n),this.on("option:"+n.name(),()=>{this._outputConfiguration.writeOut(`${e}
-`),this._exit(0,"commander.version",e)}),this}description(e,t){return e===void 0&&t===void 0?this._description:(this._description=e,t&&(this._argsDescription=t),this)}summary(e){return e===void 0?this._summary:(this._summary=e,this)}alias(e){if(e===void 0)return this._aliases[0];let t=this;if(this.commands.length!==0&&this.commands[this.commands.length-1]._executableHandler&&(t=this.commands[this.commands.length-1]),e===t._name)throw new Error("Command alias can't be the same as its name");let i=this.parent?._findCommand(e);if(i){let n=[i.name()].concat(i.aliases()).join("|");throw new Error(`cannot add alias '${e}' to command '${this.name()}' as already have command '${n}'`)}return t._aliases.push(e),this}aliases(e){return e===void 0?this._aliases:(e.forEach(t=>this.alias(t)),this)}usage(e){if(e===void 0){if(this._usage)return this._usage;let t=this.registeredArguments.map(i=>Ve(i));return[].concat(this.options.length||this._helpOption!==null?"[options]":[],this.commands.length?"[command]":[],this.registeredArguments.length?t:[]).join(" ")}return this._usage=e,this}name(e){return e===void 0?this._name:(this._name=e,this)}nameFromFilename(e){return this._name=g.basename(e,g.extname(e)),this}executableDir(e){return e===void 0?this._executableDir:(this._executableDir=e,this)}helpInformation(e){let t=this.createHelp();return t.helpWidth===void 0&&(t.helpWidth=e&&e.error?this._outputConfiguration.getErrHelpWidth():this._outputConfiguration.getOutHelpWidth()),t.formatHelp(this,t)}_getHelpContext(e){e=e||{};let t={error:!!e.error},i;return t.error?i=n=>this._outputConfiguration.writeErr(n):i=n=>this._outputConfiguration.writeOut(n),t.write=e.write||i,t.command=this,t}outputHelp(e){let t;typeof e=="function"&&(t=e,e=void 0);let i=this._getHelpContext(e);this._getCommandAndAncestors().reverse().forEach(s=>s.emit("beforeAllHelp",i)),this.emit("beforeHelp",i);let n=this.helpInformation(i);if(t&&(n=t(n),typeof n!="string"&&!Buffer.isBuffer(n)))throw new Error("outputHelp callback must return a string or a Buffer");i.write(n),this._getHelpOption()?.long&&this.emit(this._getHelpOption().long),this.emit("afterHelp",i),this._getCommandAndAncestors().forEach(s=>s.emit("afterAllHelp",i))}helpOption(e,t){return typeof e=="boolean"?(e?this._helpOption=this._helpOption??void 0:this._helpOption=null,this):(e=e??"-h, --help",t=t??"display help for command",this._helpOption=this.createOption(e,t),this)}_getHelpOption(){return this._helpOption===void 0&&this.helpOption(void 0,void 0),this._helpOption}addHelpOption(e){return this._helpOption=e,this}help(e){this.outputHelp(e);let t=m.exitCode||0;t===0&&e&&typeof e!="function"&&e.error&&(t=1),this._exit(t,"commander.help","(outputHelp)")}addHelpText(e,t){let i=["beforeAll","before","after","afterAll"];if(!i.includes(e))throw new Error(`Unexpected value for position to addHelpText.
-Expecting one of '${i.join("', '")}'`);let n=`${e}Help`;return this.on(n,s=>{let r;typeof t=="function"?r=t({error:s.error,command:s.command}):r=t,r&&s.write(`${r}
-`)}),this}_outputHelpIfRequested(e){let t=this._getHelpOption();t&&e.find(n=>t.is(n))&&(this.outputHelp(),this._exit(0,"commander.helpDisplayed","(outputHelp)"))}};function Z(a){return a.map(e=>{if(!e.startsWith("--inspect"))return e;let t,i="127.0.0.1",n="9229",s;return(s=e.match(/^(--inspect(-brk)?)$/))!==null?t=s[1]:(s=e.match(/^(--inspect(-brk|-port)?)=([^:]+)$/))!==null?(t=s[1],/^\d+$/.test(s[3])?n=s[3]:i=s[3]):(s=e.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/))!==null&&(t=s[1],i=s[3],n=s[4]),t&&n!=="0"?`${t}=${i}:${parseInt(n)+1}`:e})}ee.Command=K});var re=b(f=>{var{Argument:ie}=w(),{Command:U}=te(),{CommanderError:Re,InvalidArgumentError:ne}=A(),{Help:De}=M(),{Option:se}=I();f.program=new U;f.createCommand=a=>new U(a);f.createOption=(a,e)=>new se(a,e);f.createArgument=(a,e)=>new ie(a,e);f.Command=U;f.Option=se;f.Argument=ie;f.Help=De;f.CommanderError=Re;f.InvalidArgumentError=ne;f.InvalidOptionArgumentError=ne});var oe=Ce(re(),1),{program:ze,createCommand:Qe,createArgument:ae,createOption:Xe,CommanderError:Ze,InvalidArgumentError:et,InvalidOptionArgumentError:tt,Command:ue,Argument:it,Option:nt,Help:st}=oe.default;var le="pagerts",he="A tool for viewing external relations in a webpage",ce="0.2.0";var C=class{constructor(e){this.name=e}};var E=class extends C{constructor(){super("page-extractor")}async extract(e){let{window:{document:{title:t,location:{href:i}}}}=e;return{title:t,url:i}}};function Me(a,e){for(let t of e)if(qe(t,a))return t}var Ne=["id","innerText","textContent","class","ariaLabel","ariaDescription","alt","rel"],Fe=["href","data-src","target","action","src","url"];function me(a){for(let e of Ne){let t=a[e];if(t&&typeof t=="string"&&t.trim()!=="")return{key:e,value:t}}}function pe(a){let e=Me(a,[...Fe]),t=a[e];if(t&&typeof t=="string"&&t.trim()!=="")return{key:e,url:t}}var qe=(a,e)=>a in e&&e[a]!==void 0;var v=class extends C{constructor(t){super("page-extractor");this.tags=t}async extract(t){let{document:i}=t.window,n=[];for(let s of this.tags){let r=i.querySelectorAll(s),u=Array.from(r);for(let o of u){let l=me(o),h=pe(o);!l||!h||h.url.startsWith("http")&&n.push({text:l,link:h})}}return n}};var y=require("jsdom"),$=class{async fetchPage(e){let t,i=new y.VirtualConsole().on("jsdomError",n=>{process.stderr.write(`Error parsing ${e}:${n.message}
-`)});return e.startsWith("file://")?t=y.JSDOM.fromFile(e,{virtualConsole:i}):t=y.JSDOM.fromURL(e,{virtualConsole:i}),t.then(n=>({url:e,content:n})).catch(({message:n})=>({url:e,error:`JSDOM failed to parse: ${n}`}))}async fetchAll(e){return(await Promise.all(e.map(i=>this.fetchPage(i)))).filter(i=>i.content!==void 0)}};var S=class{constructor(){}};var k=class extends S{print(...e){let t=JSON.stringify(e);process.stdout.write(t+`
-`)}};var Ie=new ue,je=ae("<url | file...>","remote https://URL or local file://resource.html to extract from");(async()=>await Ie.name(le).version(ce,"-v, --version").description(he).addArgument(je).action(async a=>{let e=new k,t=new $,i=new E,n=new v(["a","meta","link","embed"]),s=await t.fetchAll(a),r=[];for(let{content:u,url:o,error:l}of s){let h=l in u?[]:await n.extract(u),c=l in u?{url:o,error:l}:await i.extract(u);r.push({...c,resources:h})}await e.print(...r)}).parseAsync(process.argv))();
+import{Command as j,createArgument as N}from"commander";var R={name:"pagerts",description:"A tool for viewing external relations in a webpage",version:"1.0.1",main:"main.js",bin:{pagerts:"bin/main.js"},files:["bin"],engines:{node:">=18.0.0"},scripts:{test:"jest --coverage","test:watch":"jest --watch",build:"esbuild src/main.ts --bundle --packages=external --outdir=bin --minify --sourcemap --platform=node --format=esm",lint:"eslint src/**/*.ts","lint:fix":"eslint src/**/*.ts --fix","type-check":"tsc --noEmit",format:'prettier --write "src/**/*.ts"',"format:check":'prettier --check "src/**/*.ts"',"security:audit":"npm audit --audit-level=moderate","security:check":"npm run security:audit && npm run lint",start:"node ./bin/main.js",dev:"tsx src/main.ts",prepare:"npm run build"},keywords:["webpage","hierarchy","management","web-scraping","cli","url-extraction"],author:"Kirill kn253 Nevzorov",license:"MIT",bugs:{url:"https://github.com/akinevz0/pagerts/issues"},homepage:"https://github.com/akinevz0/pagerts",dependencies:{commander:"^12.1.0",jsdom:"^25.0.1"},devDependencies:{"@types/jest":"^29.5.14","@types/jsdom":"^21.1.7","@types/node":"^22.10.5","@typescript-eslint/eslint-plugin":"^8.20.0","@typescript-eslint/parser":"^8.20.0",esbuild:"^0.25.1",eslint:"^9.18.0","eslint-config-prettier":"^9.1.0","eslint-plugin-security":"^3.0.1",jest:"^29.7.0",prettier:"^3.4.2","ts-jest":"^29.2.5",tsx:"^4.19.2",typescript:"^5.7.2"}};var a=class{constructor(e){this.name=e}};var d=class extends a{constructor(){super("page-extractor")}async extract(e){let{window:{document:{title:r,location:{href:t}}}}=e;return{title:r,url:t}}};function T(s,e){for(let r of e)if(S(r,s))return r}var k=["id","innerText","textContent","class","ariaLabel","ariaDescription","alt"],M=["href","data-src","target","action","src","url"];function w(s){for(let e of k){let r=s[e];if(r&&typeof r=="string"&&r.trim()!=="")return{key:e,value:r}}}function P(s){let e=T(s,[...M]);if(!e)return;let r=s[e];if(r&&typeof r=="string"&&r.trim()!=="")return{key:e,url:r}}var S=(s,e)=>s in e&&e[s]!==void 0;var f=class extends a{constructor(r){super("page-extractor");this.tags=r}async extract(r){let{document:t}=r.window,o=[];for(let i of this.tags){let c=t.querySelectorAll(i),u=Array.from(c);for(let m of u){let n=w(m),l=P(m);!n||!l||l.url.startsWith("http")&&o.push({text:n,link:l})}}return o}};import{JSDOM as b,VirtualConsole as A}from"jsdom";var g=class{timeout;maxRetries;constructor(e=1e4,r=2){this.timeout=e,this.maxRetries=r}async fetchPage(e,r=0){let t=new A().on("jsdomError",o=>{process.stderr.write(`Error parsing ${e}: ${o.message}
+`)});try{let o;e.startsWith("file://")?o=b.fromFile(e.substring(7),{virtualConsole:t}):o=b.fromURL(e,{virtualConsole:t,resources:"usable",runScripts:"outside-only",beforeParse(c){c.setTimeout=()=>{throw new Error("setTimeout disabled for security")},c.setInterval=()=>{throw new Error("setInterval disabled for security")}}});let i=await Promise.race([o,new Promise((c,u)=>setTimeout(()=>u(new Error("Request timeout")),this.timeout))]);return{url:e,content:i}}catch(o){let i=o instanceof Error?o.message:"Unknown error";return r<this.maxRetries&&this.isRetryableError(i)?(process.stderr.write(`Retrying ${e} (attempt ${r+1}/${this.maxRetries})...
+`),await this.delay(1e3*(r+1)),this.fetchPage(e,r+1)):{url:e,error:`Failed to fetch: ${i}`}}}isRetryableError(e){return[/timeout/i,/ECONNRESET/i,/ETIMEDOUT/i,/ENOTFOUND/i,/network/i].some(t=>t.test(e))}delay(e){return new Promise(r=>setTimeout(r,e))}async fetchAll(e){return(await Promise.all(e.map(t=>this.fetchPage(t)))).filter(t=>t.content!==void 0||t.error)}};var p=class{constructor(){}};var y=class extends p{print(...e){let r=JSON.stringify(e);process.stdout.write(r+`
+`)}};var E=["http:","https:","file:"];var D=[/javascript:/i,/data:/i,/vbscript:/i,/<script/i,/on\w+=/i];function O(s){if(!s||!s.trim())return{isValid:!1,error:"URL cannot be empty"};let e=s.trim();if(e.length>2048)return{isValid:!1,error:"URL exceeds maximum length of 2048 characters"};for(let i of D)if(i.test(e))return{isValid:!1,error:"URL contains suspicious patterns"};let r;try{r=new URL(e)}catch{return e.startsWith("file://")?{isValid:!0,sanitizedUrl:e}:{isValid:!1,error:"Invalid URL format"}}if(!E.includes(r.protocol))return{isValid:!1,error:`Protocol ${r.protocol} is not allowed. Allowed protocols: ${E.join(", ")}`};let t=r.hostname.toLowerCase();return(t==="localhost"||t==="127.0.0.1"||t==="::1"||t.startsWith("192.168.")||t.startsWith("10.")||/^172\.(1[6-9]|2\d|3[01])\./.test(t))&&r.protocol!=="file:"&&console.warn(`Warning: Accessing local network resource: ${e}`),{isValid:!0,sanitizedUrl:r.toString()}}function v(s){let e=[],r=[];for(let t of s){let o=O(t);o.isValid&&o.sanitizedUrl?e.push(o.sanitizedUrl):r.push({url:t,error:o.error||"Unknown validation error"})}return{validUrls:e,errors:r}}var{description:$,name:q,version:_}=R,V=new j,J=N("<url | file...>","remote https://URL or local file://resource.html to extract from");(async()=>await V.name(q).version(_,"-v, --version").description($).addArgument(J).action(async s=>{try{let{validUrls:e,errors:r}=v(s);r.length>0&&(console.error(`
+\u274C URL Validation Errors:`),r.forEach(({url:n,error:l})=>{console.error(`  - ${n}: ${l}`)})),e.length===0&&(console.error(`
+\u274C No valid URLs to process. Exiting.`),process.exit(1)),console.error(`
+\u2705 Processing ${e.length} valid URL(s)...`);let t=new y,o=new g,i=new d,c=new f(["a","meta","link","embed"]),u=await o.fetchAll(e),m=[];for(let{content:n,url:l,error:x}of u){let h=x!==void 0||!n?[]:await c.extract(n),U=x!==void 0||!n?{url:l,error:x??"Unknown error",resources:h}:await i.extract(n);m.push({...U,resources:h})}await t.print(...m)}catch(e){console.error(`
+\u274C An error occurred:`,e instanceof Error?e.message:e),process.exit(1)}}).parseAsync(process.argv))();
 /**
  * @license MIT
  * We are interested in visualising a page as a collection of tags.
- * 
+ *
  * We wish to work with tags that can be compactly previewed on a webpage.
  * Here we must declare all of the element types that can be used to represent
  * a resource that can be hyperlinked off a webpage.