fetch-status-codes 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+Changelog
+=========
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+[0.1.0] - 2025-11-26
+--------------------
+
+### Added
+
+- Initial release.
+
+[0.1.0]: https://github.com/jbenner-radham/node-fetch-status-codes/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, James Benner
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,53 @@
+fetch-status-codes
+==================
+
+Fetch the HTTP status codes from the [IANA](https://www.iana.org/) registry.
+
+Install
+-------
+
+```sh-session
+npm install fetch-status-codes
+```
+
+Usage
+-----
+
+```typescript
+import fetchStatusCodes from 'fetch-status-codes';
+
+await fetchStatusCodes();
+// >>> [
+// >>>   {
+// >>>     value: 100,
+// >>>     description: 'Continue'
+// >>>     references: [
+// >>>       {
+// >>>         name: 'RFC9110, Section 15.2.1',
+// >>>         url: 'https://www.rfc-editor.org/rfc/rfc9110.html#section-15.2.1'
+// >>>       }
+// >>>     ]
+// >>>   },
+// >>>   ...
+// >>> ]
+
+await fetchStatusCodes({ resolveRedirects: false });
+// >>> [
+// >>>   {
+// >>>     value: 100,
+// >>>     description: 'Continue'
+// >>>     references: [
+// >>>       {
+// >>>         name: 'RFC9110, Section 15.2.1',
+// >>>         url: 'https://www.iana.org/go/rfc9110'
+// >>>       }
+// >>>     ]
+// >>>   },
+// >>>   ...
+// >>> ]
+```
+
+License
+-------
+
+The BSD 3-Clause License. See the [license file](LICENSE) for details.

package/dist/cjs/index.js

@@ -0,0 +1,2 @@
+"use strict";var c=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var h=Object.prototype.hasOwnProperty;var x=(n,t)=>{for(var o in t)c(n,o,{get:t[o],enumerable:!0})},C=(n,t,o,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of g(t))!h.call(n,r)&&r!==o&&c(n,r,{get:()=>t[r],enumerable:!(a=y(t,r))||a.enumerable});return n};var S=n=>C(c({},"__esModule",{value:!0}),n);var A={};x(A,{default:()=>u});module.exports=S(A);var m=require("jsdom");async function u({resolveRedirects:n=!0}={}){let a=await(await fetch("https://www.iana.org/assignments/http-status-codes")).text(),d=new m.JSDOM(a).window.document.getElementById("table-http-status-codes-1"),f=Array.from(d.querySelectorAll("tbody > tr")),p=async e=>{if(!n)return e.href;let s=await fetch(e.href,{method:"HEAD",redirect:"manual"}),i=new URL(s.status===301?s.headers.get("Location"):e.href),w=/RFC\d+(?:, Section )?((?:\d+)?(?:.\d+){0,2})/,[,l]=w.exec(e.textContent)??[];return l&&(i.hash=`section-${l}`),i.toString()};return Promise.all(f.map(e=>Array.from(e.querySelectorAll("td"))).filter(e=>e.at(1).textContent!=="Unassigned").map(async e=>({value:Number.parseInt(e.at(0).textContent),description:e.at(1).textContent,references:await Promise.all(Array.from(e.at(2).querySelectorAll("a")).map(async s=>({name:s.textContent,url:await p(s)})))})))}
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["import { JSDOM } from 'jsdom';\n\nexport type Reference = { name: string; url: string };\n\nexport type StatusCode = { value: number; description: string; references: Reference[] };\n\nexport default async function fetchStatusCodes({ resolveRedirects = true }: {\n  resolveRedirects?: boolean;\n} = {}): Promise<StatusCode[]> {\n  const url = 'https://www.iana.org/assignments/http-status-codes';\n  const response = await fetch(url);\n  const html = await response.text();\n  const dom = new JSDOM(html);\n  const table = dom.window.document.getElementById('table-http-status-codes-1')!;\n  const rows = Array.from(table.querySelectorAll<HTMLTableRowElement>('tbody > tr'));\n  const getReferenceLink = async (anchor: HTMLAnchorElement): Promise<string> => {\n    if (!resolveRedirects) {\n      return anchor.href;\n    }\n\n    // The IANA links are redirects, but we want direct links with a section hash if applicable.\n    const response = await fetch(anchor.href, { method: 'HEAD', redirect: 'manual' });\n    const url = new URL(response.status === 301 ? response.headers.get('Location')! : anchor.href);\n    const pattern = /RFC\\d+(?:, Section )?((?:\\d+)?(?:.\\d+){0,2})/;\n    const [, section] = pattern.exec(anchor.textContent) ?? [];\n\n    if (section) {\n      url.hash = `section-${section}`;\n    }\n\n    return url.toString();\n  };\n\n  return Promise.all(rows.map(row => Array.from(row.querySelectorAll('td')))\n    .filter(cells => cells.at(1)!.textContent !== 'Unassigned')\n    .map(async cells => ({\n      value: Number.parseInt(cells.at(0)!.textContent),\n      description: cells.at(1)!.textContent,\n      references: await Promise.all(Array.from(cells.at(2)!.querySelectorAll('a'))\n        .map(async anchor =>\n          ({ name: anchor.textContent!, url: await getReferenceLink(anchor) })\n        )\n      )\n    })));\n}\n"],
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,IAAA,eAAAC,EAAAH,GAAA,IAAAI,EAAsB,iBAMtB,eAAOF,EAAwC,CAAE,iBAAAG,EAAmB,EAAK,EAErE,CAAC,EAA0B,CAG7B,IAAMC,EAAO,MADI,MAAM,MADX,oDACoB,GACJ,KAAK,EAE3BC,EADM,IAAI,QAAMD,CAAI,EACR,OAAO,SAAS,eAAe,2BAA2B,EACtEE,EAAO,MAAM,KAAKD,EAAM,iBAAsC,YAAY,CAAC,EAC3EE,EAAmB,MAAOC,GAA+C,CAC7E,GAAI,CAACL,EACH,OAAOK,EAAO,KAIhB,IAAMC,EAAW,MAAM,MAAMD,EAAO,KAAM,CAAE,OAAQ,OAAQ,SAAU,QAAS,CAAC,EAC1EE,EAAM,IAAI,IAAID,EAAS,SAAW,IAAMA,EAAS,QAAQ,IAAI,UAAU,EAAKD,EAAO,IAAI,EACvFG,EAAU,+CACV,CAAC,CAAEC,CAAO,EAAID,EAAQ,KAAKH,EAAO,WAAW,GAAK,CAAC,EAEzD,OAAII,IACFF,EAAI,KAAO,WAAWE,CAAO,IAGxBF,EAAI,SAAS,CACtB,EAEA,OAAO,QAAQ,IAAIJ,EAAK,IAAIO,GAAO,MAAM,KAAKA,EAAI,iBAAiB,IAAI,CAAC,CAAC,EACtE,OAAOC,GAASA,EAAM,GAAG,CAAC,EAAG,cAAgB,YAAY,EACzD,IAAI,MAAMA,IAAU,CACnB,MAAO,OAAO,SAASA,EAAM,GAAG,CAAC,EAAG,WAAW,EAC/C,YAAaA,EAAM,GAAG,CAAC,EAAG,YAC1B,WAAY,MAAM,QAAQ,IAAI,MAAM,KAAKA,EAAM,GAAG,CAAC,EAAG,iBAAiB,GAAG,CAAC,EACxE,IAAI,MAAMN,IACR,CAAE,KAAMA,EAAO,YAAc,IAAK,MAAMD,EAAiBC,CAAM,CAAE,EACpE,CACF,CACF,EAAE,CAAC,CACP",
+  "names": ["index_exports", "__export", "fetchStatusCodes", "__toCommonJS", "import_jsdom", "resolveRedirects", "html", "table", "rows", "getReferenceLink", "anchor", "response", "url", "pattern", "section", "row", "cells"]
+}

package/dist/cjs/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "fetch-status-codes",
+  "version": "0.1.0",
+  "description": "Fetch the HTTP status codes from the IANA registry.",
+  "keywords": [],
+  "homepage": "https://github.com/jbenner-radham/node-fetch-status-codes#readme",
+  "bugs": {
+    "url": "https://github.com/jbenner-radham/node-fetch-status-codes/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jbenner-radham/node-fetch-status-codes.git"
+  },
+  "license": "BSD-3-Clause",
+  "author": "James Benner <hello@jamesbenner.com> (https://www.jamesbenner.com/)",
+  "sideEffects": false,
+  "type": "commonjs",
+  "exports": "./index.js",
+  "types": "../types/index.d.ts",
+  "dependencies": {
+    "jsdom": "^27.2.0"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.0.0",
+    "@eslint/json": "^0.14.0",
+    "@radham/eslint-config": "^11.0.0",
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^22.18.8",
+    "@vitest/coverage-v8": "^4.0.14",
+    "duo-build": "^0.2.1",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "rimraf": "^6.1.2",
+    "sort-package-json": "^3.4.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.14"
+  },
+  "packageManager": "pnpm@10.23.0",
+  "engines": {
+    "node": ">=22"
+  }
+}

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+import{JSDOM as m}from"jsdom";async function u({resolveRedirects:o=!0}={}){let s=await(await fetch("https://www.iana.org/assignments/http-status-codes")).text(),a=new m(s).window.document.getElementById("table-http-status-codes-1"),c=Array.from(a.querySelectorAll("tbody > tr")),i=async e=>{if(!o)return e.href;let t=await fetch(e.href,{method:"HEAD",redirect:"manual"}),n=new URL(t.status===301?t.headers.get("Location"):e.href),l=/RFC\d+(?:, Section )?((?:\d+)?(?:.\d+){0,2})/,[,r]=l.exec(e.textContent)??[];return r&&(n.hash=`section-${r}`),n.toString()};return Promise.all(c.map(e=>Array.from(e.querySelectorAll("td"))).filter(e=>e.at(1).textContent!=="Unassigned").map(async e=>({value:Number.parseInt(e.at(0).textContent),description:e.at(1).textContent,references:await Promise.all(Array.from(e.at(2).querySelectorAll("a")).map(async t=>({name:t.textContent,url:await i(t)})))})))}export{u as default};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["import { JSDOM } from 'jsdom';\n\nexport type Reference = { name: string; url: string };\n\nexport type StatusCode = { value: number; description: string; references: Reference[] };\n\nexport default async function fetchStatusCodes({ resolveRedirects = true }: {\n  resolveRedirects?: boolean;\n} = {}): Promise<StatusCode[]> {\n  const url = 'https://www.iana.org/assignments/http-status-codes';\n  const response = await fetch(url);\n  const html = await response.text();\n  const dom = new JSDOM(html);\n  const table = dom.window.document.getElementById('table-http-status-codes-1')!;\n  const rows = Array.from(table.querySelectorAll<HTMLTableRowElement>('tbody > tr'));\n  const getReferenceLink = async (anchor: HTMLAnchorElement): Promise<string> => {\n    if (!resolveRedirects) {\n      return anchor.href;\n    }\n\n    // The IANA links are redirects, but we want direct links with a section hash if applicable.\n    const response = await fetch(anchor.href, { method: 'HEAD', redirect: 'manual' });\n    const url = new URL(response.status === 301 ? response.headers.get('Location')! : anchor.href);\n    const pattern = /RFC\\d+(?:, Section )?((?:\\d+)?(?:.\\d+){0,2})/;\n    const [, section] = pattern.exec(anchor.textContent) ?? [];\n\n    if (section) {\n      url.hash = `section-${section}`;\n    }\n\n    return url.toString();\n  };\n\n  return Promise.all(rows.map(row => Array.from(row.querySelectorAll('td')))\n    .filter(cells => cells.at(1)!.textContent !== 'Unassigned')\n    .map(async cells => ({\n      value: Number.parseInt(cells.at(0)!.textContent),\n      description: cells.at(1)!.textContent,\n      references: await Promise.all(Array.from(cells.at(2)!.querySelectorAll('a'))\n        .map(async anchor =>\n          ({ name: anchor.textContent!, url: await getReferenceLink(anchor) })\n        )\n      )\n    })));\n}\n"],
+  "mappings": "AAAA,OAAS,SAAAA,MAAa,QAMtB,eAAOC,EAAwC,CAAE,iBAAAC,EAAmB,EAAK,EAErE,CAAC,EAA0B,CAG7B,IAAMC,EAAO,MADI,MAAM,MADX,oDACoB,GACJ,KAAK,EAE3BC,EADM,IAAIJ,EAAMG,CAAI,EACR,OAAO,SAAS,eAAe,2BAA2B,EACtEE,EAAO,MAAM,KAAKD,EAAM,iBAAsC,YAAY,CAAC,EAC3EE,EAAmB,MAAOC,GAA+C,CAC7E,GAAI,CAACL,EACH,OAAOK,EAAO,KAIhB,IAAMC,EAAW,MAAM,MAAMD,EAAO,KAAM,CAAE,OAAQ,OAAQ,SAAU,QAAS,CAAC,EAC1EE,EAAM,IAAI,IAAID,EAAS,SAAW,IAAMA,EAAS,QAAQ,IAAI,UAAU,EAAKD,EAAO,IAAI,EACvFG,EAAU,+CACV,CAAC,CAAEC,CAAO,EAAID,EAAQ,KAAKH,EAAO,WAAW,GAAK,CAAC,EAEzD,OAAII,IACFF,EAAI,KAAO,WAAWE,CAAO,IAGxBF,EAAI,SAAS,CACtB,EAEA,OAAO,QAAQ,IAAIJ,EAAK,IAAIO,GAAO,MAAM,KAAKA,EAAI,iBAAiB,IAAI,CAAC,CAAC,EACtE,OAAOC,GAASA,EAAM,GAAG,CAAC,EAAG,cAAgB,YAAY,EACzD,IAAI,MAAMA,IAAU,CACnB,MAAO,OAAO,SAASA,EAAM,GAAG,CAAC,EAAG,WAAW,EAC/C,YAAaA,EAAM,GAAG,CAAC,EAAG,YAC1B,WAAY,MAAM,QAAQ,IAAI,MAAM,KAAKA,EAAM,GAAG,CAAC,EAAG,iBAAiB,GAAG,CAAC,EACxE,IAAI,MAAMN,IACR,CAAE,KAAMA,EAAO,YAAc,IAAK,MAAMD,EAAiBC,CAAM,CAAE,EACpE,CACF,CACF,EAAE,CAAC,CACP",
+  "names": ["JSDOM", "fetchStatusCodes", "resolveRedirects", "html", "table", "rows", "getReferenceLink", "anchor", "response", "url", "pattern", "section", "row", "cells"]
+}

package/dist/esm/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "fetch-status-codes",
+  "version": "0.1.0",
+  "description": "Fetch the HTTP status codes from the IANA registry.",
+  "keywords": [],
+  "homepage": "https://github.com/jbenner-radham/node-fetch-status-codes#readme",
+  "bugs": {
+    "url": "https://github.com/jbenner-radham/node-fetch-status-codes/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jbenner-radham/node-fetch-status-codes.git"
+  },
+  "license": "BSD-3-Clause",
+  "author": "James Benner <hello@jamesbenner.com> (https://www.jamesbenner.com/)",
+  "sideEffects": false,
+  "type": "module",
+  "exports": "./index.js",
+  "types": "../types/index.d.ts",
+  "dependencies": {
+    "jsdom": "^27.2.0"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.0.0",
+    "@eslint/json": "^0.14.0",
+    "@radham/eslint-config": "^11.0.0",
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^22.18.8",
+    "@vitest/coverage-v8": "^4.0.14",
+    "duo-build": "^0.2.1",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "rimraf": "^6.1.2",
+    "sort-package-json": "^3.4.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.14"
+  },
+  "packageManager": "pnpm@10.23.0",
+  "engines": {
+    "node": ">=22"
+  }
+}

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+export type Reference = {
+    name: string;
+    url: string;
+};
+export type StatusCode = {
+    value: number;
+    description: string;
+    references: Reference[];
+};
+export default function fetchStatusCodes({ resolveRedirects }?: {
+    resolveRedirects?: boolean;
+}): Promise<StatusCode[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC;AAEzF,wBAA8B,gBAAgB,CAAC,EAAE,gBAAuB,EAAE,GAAE;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAoC7B"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "fetch-status-codes",
+  "version": "0.1.0",
+  "description": "Fetch the HTTP status codes from the IANA registry.",
+  "keywords": [],
+  "homepage": "https://github.com/jbenner-radham/node-fetch-status-codes#readme",
+  "bugs": {
+    "url": "https://github.com/jbenner-radham/node-fetch-status-codes/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jbenner-radham/node-fetch-status-codes.git"
+  },
+  "license": "BSD-3-Clause",
+  "author": "James Benner <hello@jamesbenner.com> (https://www.jamesbenner.com/)",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    "import": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/esm/index.js"
+    },
+    "require": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "jsdom": "^27.2.0"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.0.0",
+    "@eslint/json": "^0.14.0",
+    "@radham/eslint-config": "^11.0.0",
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^22.18.8",
+    "@vitest/coverage-v8": "^4.0.14",
+    "duo-build": "^0.2.1",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "rimraf": "^6.1.2",
+    "sort-package-json": "^3.4.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.14"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "prebuild": "rimraf ./dist",
+    "build": "duo-build --packages external --platform node",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:log": "vitest run --silent passed-only",
+    "test:watch": "vitest"
+  }
+}