{"_id":"@cynthiateeters/check-see-links","_rev":"1-6a80e1b3ecea71f53a34afd869b60c0e","name":"@cynthiateeters/check-see-links","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@cynthiateeters/check-see-links","version":"1.0.0","keywords":["mdn","links","cli","javascript","dev"],"author":{"url":"https://github.com/cynthiateeters","name":"Cynthia Teeters","email":"cynthiateeters@gmail.com"},"license":"MIT","_id":"@cynthiateeters/check-see-links@1.0.0","maintainers":[{"name":"cynthiateeters","email":"cynthiateeters@gmail.com"}],"homepage":"https://github.com/cynthiateeters/check-see-links#readme","bugs":{"url":"https://github.com/cynthiateeters/check-see-links/issues"},"bin":{"check-see-links":"index.js"},"dist":{"shasum":"ceb3c429f5ce0a4091479d692f03541b62e9d3f1","tarball":"https://registry.npmjs.org/@cynthiateeters/check-see-links/-/check-see-links-1.0.0.tgz","fileCount":5,"integrity":"sha512-tKqM9F4USjzU/lzwzuWX2pAzaP/ChzWrDsayw/YnOaLbNLm7puYJufng1fmhWs7Ii9KIAAf4X3XBXRwI4r9dOQ==","signatures":[{"sig":"MEYCIQCSmKGBo/7yN1es6RKPK+6Pe4il7HaiG/m34N0VyLi/1wIhAI9m/18eUPzgPxs3lg/ChoSwzPZhmvB6oWYxaH/80ZZr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9410},"main":"index.js","gitHead":"a21719ad28f83c1a49fc583202eb0d5eca7ad078","scripts":{"lint":"eslint .","test":"vitest --run","check-links":"node index.js"},"_npmUser":{"name":"cynthiateeters","email":"cynthiateeters@gmail.com"},"repository":{"url":"git+https://github.com/cynthiateeters/check-see-links.git","type":"git"},"_npmVersion":"10.2.3","description":"CLI tool to check @see links in tracked JavaScript files","directories":{},"_nodeVersion":"20.10.0","_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.20.0","vitest":"^3.0.5","globals":"^15.14.0","@eslint/js":"^9.20.0"},"_npmOperationalInternal":{"tmp":"tmp/check-see-links_1.0.0_1739136379081_0.5893929222097247","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@cynthiateeters/check-see-links","version":"1.1.0","description":"CLI tool to check @see links in tracked JavaScript files","main":"index.js","bin":{"check-see-links":"index.js"},"scripts":{"test":"vitest --run","lint":"eslint .","check-links":"node index.js"},"keywords":["mdn","links","cli","javascript","dev"],"repository":{"type":"git","url":"git+https://github.com/cynthiateeters/check-see-links.git"},"author":{"name":"Cynthia Teeters","email":"cynthiateeters@gmail.com","url":"https://github.com/cynthiateeters"},"license":"MIT","devDependencies":{"@eslint/js":"^9.20.0","eslint":"^9.20.0","globals":"^15.14.0","vitest":"^3.0.5"},"_id":"@cynthiateeters/check-see-links@1.1.0","gitHead":"104ce1bbe62a52fbe244cd274a3fbbdc6ac32913","bugs":{"url":"https://github.com/cynthiateeters/check-see-links/issues"},"homepage":"https://github.com/cynthiateeters/check-see-links#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-uetkAfAuFvxUrSi7Sf00JSAwGH/XluY1c3MexRAuIqmufI0MygVvR+FfklPI+DF2NMojvjp+/2XYrTjZ8yxjBA==","shasum":"5330c0eee7288fad7fcc214a0f502f13b25501ba","tarball":"https://registry.npmjs.org/@cynthiateeters/check-see-links/-/check-see-links-1.1.0.tgz","fileCount":6,"unpackedSize":7287,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDDFZ6ttrPormWCulH6seEezwF3cWChaeccgC0ZSVnqJAiEAl1fw/Au886XtX/F3WpBza/dRE5CtMVsTKsuC83LjUG8="}]},"_npmUser":{"name":"cynthiateeters","email":"cynthiateeters@gmail.com"},"directories":{},"maintainers":[{"name":"cynthiateeters","email":"cynthiateeters@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/check-see-links_1.1.0_1740860777993_0.43965895983743897"},"_hasShrinkwrap":false}},"time":{"created":"2025-02-09T21:26:18.994Z","modified":"2025-03-01T20:26:18.373Z","1.0.0":"2025-02-09T21:26:19.272Z","1.1.0":"2025-03-01T20:26:18.193Z"},"bugs":{"url":"https://github.com/cynthiateeters/check-see-links/issues"},"author":{"name":"Cynthia Teeters","email":"cynthiateeters@gmail.com","url":"https://github.com/cynthiateeters"},"license":"MIT","homepage":"https://github.com/cynthiateeters/check-see-links#readme","keywords":["mdn","links","cli","javascript","dev"],"repository":{"type":"git","url":"git+https://github.com/cynthiateeters/check-see-links.git"},"description":"CLI tool to check @see links in tracked JavaScript files","maintainers":[{"name":"cynthiateeters","email":"cynthiateeters@gmail.com"}],"readme":"# @cynthiateeters/check-see-links\n\nA Node.js command-line tool that scans all tracked JavaScript files for MDN `@see` links and verifies that they are not broken. This package uses Git to filter out files listed in `.gitignore` and checks each link using HTTP requests via the global `fetch` API.\n\n## Features\n\n- **File Discovery:**\n  Uses `git ls-files '*.js'` to list only tracked JavaScript files, automatically skipping files ignored by Git.\n\n- **Link Extraction:**\n  Searches for `@see` comments in your source files and extracts URLs (assuming they are enclosed in quotes).\n\n- **Link Validation:**\n  Checks each extracted URL by performing an HTTP request (with a 10-second timeout) and reports any broken links (i.e. those not returning HTTP status 200).\n\n- **Command-Line Flags:**\n  - `-v` or `--verbose`: Print detailed progress messages, including each URL being checked.\n  - `-s` or `--silent`: Suppress all console output except errors.\n\n- **Clean Exit:**\n  Exits with status code `0` if no broken links are found, or `1` if one or more broken links are detected.\n\n## Requirements\n\n- **Node.js:** Version 18 or later is required for built-in `fetch` and `AbortController` support.\n- **Git:** Must be installed, as the tool uses Git to list tracked JavaScript files.\n\n## Installation\n\nYou can install this package as a dev dependency in your project:\n\n```bash\nnpm install --save-dev @cynthiateeters/check-see-links","readmeFilename":"README.md"}