@neoncitylights/typed-http

A TypeScript package that provides strongly typed HTTP header names. Supports the Fetch API, XmlHttpRequest, and the Node.js HTTP module with zero-runtime overhead.

This package uses an open-source JSON dataset by WebConcepts with slight modifications, available under concepts.json. The script to auto-generate the TypeScript files is available under generateHttpTypes.ts. The generated files are:

• httpHeaders.ts: 248 HTTP header types
• httpMethods.ts: 40 HTTP method types
• httpStatusCodes.ts: 63 HTTP status code types

Install

npm install @neoncitylights/typed-http

Documentation

Auto-generated API documentation is available.

API Reference

Note: Specific HTTP headers, methods, and status codes are omitted from the API documentation for brevity. The full list of types is available in the source code.

• T: # headers.HttpHeader • source
• T: # headers.HttpRequestHeader • source
• T: # headers.HttpResponseHeader • source
• T: # headers.ForbiddenHttpRequestHeader • source
• T: # headers.ForbiddenHttpResponseHeader • source
• T: # methods.HttpMethod • source
• T: # statusCodes.HttpStatusCode • source
• T: # statusCodes.HttpInfoStatusCode • source
• T: # statusCodes.HttpSuccessStatusCode • source
• T: # statusCodes.HttpRedirectStatusCode • source
• T: # statusCodes.HttpClientErrorStatusCode • source
• T: # statusCodes.HttpServerErrorStatusCode • source

Usage

Type the Fetch API

1import '@neoncitylights/typed-http/fetch';
2
3let request = await fetch();

Type XmlHttpRequest

1import '@neoncitylights/typed-http/xhr';
2
3const xhr = new XMLHttpRequest();
4xhr.addEventListener('load', (e) => console.log(xhr.responseText));
5xhr.open('GET', 'https://www.google.com');
6xhr.send();

Type the Node.js HTTP module

1import '@neoncitylights/typed-http/node';

License

This library is licensed under the MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT).

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the MIT license, shall be licensed as above, without any additional terms or conditions.