@prexjs/statuses 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Prexjs (https://prexjs.com)
+Copyright (c) 2026 Sorabh (https://Sorabh.org)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,98 @@
-# Temporary Holding Version
+# @prexjs/statuses
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**HTTP status code and reason phrase utility with category checks for redirects, empty bodies, and retries.**
+
+[![npm version](https://img.shields.io/npm/v/@prexjs/statuses)](https://www.npmjs.com/package/@prexjs/statuses)
+[![npm downloads](https://img.shields.io/npm/dm/@prexjs/statuses)](https://www.npmjs.com/package/@prexjs/statuses)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-supported-blue)](https://www.typescriptlang.org/)
+
+`@prexjs/statuses` provides lookup between HTTP status codes (e.g. `404`) and standard status messages (e.g. `'Not Found'`), alongside convenient dictionaries for status categorization (`redirect`, `empty`, `retry`).
+
+## Features
+
+- Bi-directional lookup between HTTP status codes and phrases.
+- Categorization maps: `statuses.redirect`, `statuses.empty`, `statuses.retry`.
+- Complete list of standard codes: `statuses.codes`.
+- Dual ES Module (`.mjs`) and CommonJS (`.cjs`) support with TypeScript definitions.
+- Zero runtime dependencies.
+
+## Installation
+
+Install using your preferred package manager:
+
+```bash
+# npm
+npm install @prexjs/statuses
+
+# pnpm
+pnpm add @prexjs/statuses
+
+# Yarn
+yarn add @prexjs/statuses
+
+# Bun
+bun add @prexjs/statuses
+```
+
+## Quick start
+
+```ts
+import statuses from '@prexjs/statuses';
+
+// Status code to message
+console.log(statuses(200)); // 'OK'
+console.log(statuses(404)); // 'Not Found'
+
+// Message to status code
+console.log(statuses('not found')); // 404
+console.log(statuses('bad request')); // 400
+```
+
+Both default and named exports are supported:
+
+```ts
+import statuses, {
+  message,
+  code,
+  codes,
+  redirect,
+  empty,
+  retry,
+} from '@prexjs/statuses';
+```
+
+## Examples
+
+### Checking status categories
+
+```ts
+import statuses from '@prexjs/statuses';
+
+// Check if a status requires an empty body (204, 205, 304)
+if (statuses.empty[res.statusCode]) {
+  res.end();
+}
+
+// Check if a status is a redirect (300, 301, 302, 303, 305, 307, 308)
+if (statuses.redirect[res.statusCode]) {
+  console.log('Redirecting...');
+}
+
+// Check if a status indicates a retryable server error (502, 503, 504)
+if (statuses.retry[res.statusCode]) {
+  // schedule retry
+}
+```
+
+## Compatibility
+
+`@prexjs/statuses` runs anywhere ECMAScript executes (Node.js, Deno, Bun, browser).
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE](./LICENSE) for the full license text.
+
+## Related projects
+
+- [prex.js](https://github.com/prexjs/prex.js) — prex.js monorepo and ecosystem.

package/lib/index.cjs

@@ -0,0 +1,7 @@
+/*!
+ * @prexjs/statuses
+ * Copyright (c) 2026 Prexjs (https://prexjs.com)
+ * Copyright (c) 2026 Sorabh (https://Sorabh.org)
+ * MIT Licensed
+ */
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const e={100:"Continue",101:"Switching Protocols",102:"Processing",103:"Early Hints",200:"OK",201:"Created",202:"Accepted",203:"Non-Authoritative Information",204:"No Content",205:"Reset Content",206:"Partial Content",207:"Multi-Status",208:"Already Reported",226:"IM Used",300:"Multiple Choices",301:"Moved Permanently",302:"Found",303:"See Other",304:"Not Modified",305:"Use Proxy",307:"Temporary Redirect",308:"Permanent Redirect",400:"Bad Request",401:"Unauthorized",402:"Payment Required",403:"Forbidden",404:"Not Found",405:"Method Not Allowed",406:"Not Acceptable",407:"Proxy Authentication Required",408:"Request Timeout",409:"Conflict",410:"Gone",411:"Length Required",412:"Precondition Failed",413:"Payload Too Large",414:"URI Too Long",415:"Unsupported Media Type",416:"Range Not Satisfiable",417:"Expectation Failed",418:"I'm a Teapot",421:"Misdirected Request",422:"Unprocessable Entity",423:"Locked",424:"Failed Dependency",425:"Too Early",426:"Upgrade Required",428:"Precondition Required",429:"Too Many Requests",431:"Request Header Fields Too Large",451:"Unavailable For Legal Reasons",500:"Internal Server Error",501:"Not Implemented",502:"Bad Gateway",503:"Service Unavailable",504:"Gateway Timeout",505:"HTTP Version Not Supported",506:"Variant Also Negotiates",507:"Insufficient Storage",508:"Loop Detected",509:"Bandwidth Limit Exceeded",510:"Not Extended",511:"Network Authentication Required"};const t=function(e){const t={};return Object.keys(e).forEach(o=>{const r=Number(o);t[e[r].toLowerCase()]=r}),t}(e),o=function(e){return Object.keys(e).map(e=>Number(e))}(e),r={300:!0,301:!0,302:!0,303:!0,305:!0,307:!0,308:!0},n={204:!0,205:!0,304:!0},a={502:!0,503:!0,504:!0};function i(t){if(!Object.prototype.hasOwnProperty.call(e,t))throw new Error("invalid status code: "+t);return e[t]}const s=Object.assign(function(e){if("number"==typeof e)return i(e);if("string"!=typeof e)throw new TypeError("code must be a number or string");const o=parseInt(e,10);return isNaN(o)?function(e){const o=e.toLowerCase();if(!Object.prototype.hasOwnProperty.call(t,o))throw new Error('invalid status message: "'+e+'"');return t[o]}(e):i(o)},{message:e,code:t,codes:o,redirect:r,empty:n,retry:a});s.default=s,s.statuses=s,exports.code=t,exports.codes=o,exports.default=s,exports.empty=n,exports.message=e,exports.redirect=r,exports.retry=a,exports.statuses=s;

package/lib/index.d.cts

@@ -0,0 +1,27 @@
+declare const codes: Record<number, string>;
+declare const codeMap: Record<string, number>;
+declare const codeList: number[];
+declare const redirect: Record<number, boolean>;
+declare const empty: Record<number, boolean>;
+declare const retry: Record<number, boolean>;
+/**
+ * Get the status code.
+ *
+ * Given a number, this will throw if it is not a known status
+ * code, otherwise the message will be returned. Given a string,
+ * the string will be parsed for a number and return the message
+ * if valid, otherwise will lookup the code assuming this is
+ * the status message.
+ */
+declare function status(code: number): string;
+declare function status(code: string): string | number;
+declare const statuses: typeof status & {
+    message: Record<number, string>;
+    code: Record<string, number>;
+    codes: number[];
+    redirect: Record<number, boolean>;
+    empty: Record<number, boolean>;
+    retry: Record<number, boolean>;
+};
+
+export { codeMap as code, codeList as codes, statuses as default, empty, codes as message, redirect, retry, statuses };

package/lib/index.d.mts

@@ -0,0 +1,27 @@
+declare const codes: Record<number, string>;
+declare const codeMap: Record<string, number>;
+declare const codeList: number[];
+declare const redirect: Record<number, boolean>;
+declare const empty: Record<number, boolean>;
+declare const retry: Record<number, boolean>;
+/**
+ * Get the status code.
+ *
+ * Given a number, this will throw if it is not a known status
+ * code, otherwise the message will be returned. Given a string,
+ * the string will be parsed for a number and return the message
+ * if valid, otherwise will lookup the code assuming this is
+ * the status message.
+ */
+declare function status(code: number): string;
+declare function status(code: string): string | number;
+declare const statuses: typeof status & {
+    message: Record<number, string>;
+    code: Record<string, number>;
+    codes: number[];
+    redirect: Record<number, boolean>;
+    empty: Record<number, boolean>;
+    retry: Record<number, boolean>;
+};
+
+export { codeMap as code, codeList as codes, statuses as default, empty, codes as message, redirect, retry, statuses };

package/lib/index.mjs

@@ -0,0 +1,7 @@
+/*!
+ * @prexjs/statuses
+ * Copyright (c) 2026 Prexjs (https://prexjs.com)
+ * Copyright (c) 2026 Sorabh (https://Sorabh.org)
+ * MIT Licensed
+ */
+const e={100:"Continue",101:"Switching Protocols",102:"Processing",103:"Early Hints",200:"OK",201:"Created",202:"Accepted",203:"Non-Authoritative Information",204:"No Content",205:"Reset Content",206:"Partial Content",207:"Multi-Status",208:"Already Reported",226:"IM Used",300:"Multiple Choices",301:"Moved Permanently",302:"Found",303:"See Other",304:"Not Modified",305:"Use Proxy",307:"Temporary Redirect",308:"Permanent Redirect",400:"Bad Request",401:"Unauthorized",402:"Payment Required",403:"Forbidden",404:"Not Found",405:"Method Not Allowed",406:"Not Acceptable",407:"Proxy Authentication Required",408:"Request Timeout",409:"Conflict",410:"Gone",411:"Length Required",412:"Precondition Failed",413:"Payload Too Large",414:"URI Too Long",415:"Unsupported Media Type",416:"Range Not Satisfiable",417:"Expectation Failed",418:"I'm a Teapot",421:"Misdirected Request",422:"Unprocessable Entity",423:"Locked",424:"Failed Dependency",425:"Too Early",426:"Upgrade Required",428:"Precondition Required",429:"Too Many Requests",431:"Request Header Fields Too Large",451:"Unavailable For Legal Reasons",500:"Internal Server Error",501:"Not Implemented",502:"Bad Gateway",503:"Service Unavailable",504:"Gateway Timeout",505:"HTTP Version Not Supported",506:"Variant Also Negotiates",507:"Insufficient Storage",508:"Loop Detected",509:"Bandwidth Limit Exceeded",510:"Not Extended",511:"Network Authentication Required"};const t=function(e){const t={};return Object.keys(e).forEach(o=>{const r=Number(o);t[e[r].toLowerCase()]=r}),t}(e),o=function(e){return Object.keys(e).map(e=>Number(e))}(e),r={300:!0,301:!0,302:!0,303:!0,305:!0,307:!0,308:!0},n={204:!0,205:!0,304:!0},a={502:!0,503:!0,504:!0};function i(t){if(!Object.prototype.hasOwnProperty.call(e,t))throw new Error("invalid status code: "+t);return e[t]}const s=Object.assign(function(e){if("number"==typeof e)return i(e);if("string"!=typeof e)throw new TypeError("code must be a number or string");const o=parseInt(e,10);return isNaN(o)?function(e){const o=e.toLowerCase();if(!Object.prototype.hasOwnProperty.call(t,o))throw new Error('invalid status message: "'+e+'"');return t[o]}(e):i(o)},{message:e,code:t,codes:o,redirect:r,empty:n,retry:a});s.default=s,s.statuses=s;export{t as code,o as codes,s as default,n as empty,e as message,r as redirect,a as retry,s as statuses};

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@prexjs/statuses",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "HTTP status code and reason phrase utility with category checks for redirects, empty bodies, and retries.",
+  "authors": [
+    {
+      "name": "Prexjs",
+      "email": "hello@prexjs.com",
+      "url": "https://prexjs.com"
+    },
+    {
+      "name": "Sorabh",
+      "email": "hello@sorabh.org",
+      "url": "https://sorabh.org"
+    }
+  ],
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./lib/index.cjs",
+  "module": "./lib/index.mjs",
+  "types": "./lib/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./lib/index.d.mts",
+        "default": "./lib/index.mjs"
+      },
+      "require": {
+        "types": "./lib/index.d.cts",
+        "default": "./lib/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/prexjs/prex.js.git",
+    "directory": "packages/statuses"
+  },
+  "homepage": "https://github.com/prexjs/prex.js/tree/main/packages/statuses#readme",
+  "bugs": {
+    "url": "https://github.com/prexjs/prex.js/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "prexjs",
+    "statuses",
+    "status",
+    "http",
+    "status-codes",
+    "status-message",
+    "404",
+    "200",
+    "500",
+    "redirect",
+    "typescript"
+  ]
+}