@se-oss/status-codes

@se-oss/status-codes offers strongly typed utilities to safely convert between HTTP status phrases and their numeric codes. Enjoy full TypeScript type safety and compile-time checks in your projects.

---

• Installation
• Usage
• Documentation
• Contributing
• References
• License

📦 Installation

1npm i @se-oss/status-codes

📖 Usage

1import { getStatusCode, getStatusPhrase, StatusCodes, StatusPhrases } from '@se-oss/status-codes';
2
3getStatusPhrase(200); // returns 'Ok'
4getStatusPhrase(StatusCodes.CREATED); // returns 'Created'
5getStatusPhrase(418); // returns "I'm a teapot"
6
7getStatusCode('OK'); // returns 200
8getStatusCode('CREATED'); // returns 201
9
10console.log(StatusCodes.FORBIDDEN); // prints 403
11console.log(StatusPhrases.IM_A_TEAPOT); // prints "I'm a teapot"

📚 Documentation

For all configuration options, please see the API docs.

API

1/**
2 * Returns the HTTP status code for a given status phrase.
3 *
4 * @param phrase - The HTTP status phrase
5 * @returns The corresponding HTTP status code
6 * @throws {TypeError} If input is not valid or phrase is unknown
7 */
8declare function getStatusCode<T, U>(phrase: T): U;
9
10/**
11 * Returns the HTTP status phrase for a given status code.
12 *
13 * @param code - The HTTP status code
14 * @returns The corresponding HTTP status phrase
15 * @throws {TypeError} If input is not valid or code is unknown
16 */
17declare function getStatusPhrase<T, C, U>(code: T): U;

🤝 Contributing

Want to contribute? Awesome! To show your support is to star the project, or to raise issues on GitHub.

Thanks again for your support, it is much appreciated! 🙏

📑 References

• MDN Web Docs: HTTP Status Codes

License

MIT © Shahrad Elahi and contributors.