Update documentation

Author: tkrotoff

README.md

@@ -3,7 +3,7 @@
 [![npm version](https://badge.fury.io/js/%40tkrotoff%2Ffetch.svg)](https://www.npmjs.com/package/@tkrotoff/fetch)
 [![Node.js CI](https://github.com/tkrotoff/fetch/workflows/Node.js%20CI/badge.svg?branch=master)](https://github.com/tkrotoff/fetch/actions)
 [![Test Coverage](https://api.codeclimate.com/v1/badges/67aaf07dd7577e2ef340/test_coverage)](https://codeclimate.com/github/tkrotoff/fetch/test_coverage)
-[![Bundle size](https://badgen.net/bundlephobia/minzip/@tkrotoff/fetch)](https://bundlephobia.com/result?p=@tkrotoff/fetch)
+[![Bundle size](https://badgen.net/bundlephobia/minzip/@tkrotoff/fetch)](https://bundlephobia.com/package/@tkrotoff/fetch)
 [![Prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)
 [![Airbnb Code Style](https://badgen.net/badge/code%20style/airbnb/ff5a5f?icon=airbnb)](https://github.com/airbnb/javascript)
 
@@ -143,6 +143,9 @@ import { HttpStatus } from '@tkrotoff/fetch';
 console.log(HttpStatus._201_Created);
 console.log(HttpStatus._403_Forbidden);
 console.log(HttpStatus._503_ServiceUnavailable);
+
+type HttpStatusEnum = typeof HttpStatus[keyof typeof HttpStatus];
+const status: HttpStatusEnum = HttpStatus._200_OK;
 ```
 
 ### Configuration

src/Http.ts

@@ -2,7 +2,10 @@ import { entriesToObject } from './utils/entriesToObject';
 import { wait } from './utils/wait';
 import { HttpError } from './HttpError';
 
-// https://github.com/microsoft/TypeScript/blob/v4.4.4/lib/lib.dom.d.ts#L2446-L2450
+/**
+ * `Promise<`[`Response`](https://fetch.spec.whatwg.org/#response)`>` with added methods from [`Body`](https://fetch.spec.whatwg.org/#body-mixin).
+ */
+// https://github.com/microsoft/TypeScript/blob/v4.7.4/lib/lib.dom.d.ts#L2503-L2507
 export type ResponsePromiseWithBodyMethods = Promise<Response> &
   Pick<Body, 'arrayBuffer' | 'blob' | 'formData' | /*'json' |*/ 'text'> & {
     // FIXME https://github.com/microsoft/TypeScript/issues/26188

src/HttpStatus.ts

@@ -1,15 +1,18 @@
 /**
- * List of HTTP status codes.
- *
  * [List of HTTP status codes](http://en.wikipedia.org/wiki/List_of_HTTP_status_codes)
- * [Rails HTTP Status Code to Symbol Mapping](https://web.archive.org/web/20131211220540/http://www.codyfauser.com/2008/7/4/rails-http-status-code-to-symbol-mapping)
- *
- * https://www.rubydoc.info/github/rack/rack/master/Rack/Utils#HTTP_STATUS_CODES-constant
  *
- * curl -s https://www.iana.org/assignments/http-status-codes/http-status-codes-1.csv | \
- * ruby -ne 'm = /^(\d{3}),(?!Unassigned|\(Unused\))([^,]+)/.match($_) and \
- * puts "_#{m[1]}_#{m[2].delete %Q[ ]} = #{m[1]},"'
+ * With TypeScript use `typeof HttpStatus[keyof typeof HttpStatus]` to pull out the values
+ * (https://www.typescriptlang.org/docs/handbook/enums.html#objects-vs-enums)
  */
+// [Rails HTTP Status Code to Symbol Mapping](https://web.archive.org/web/20131211220540/http://www.codyfauser.com/2008/7/4/rails-http-status-code-to-symbol-mapping)
+//
+// https://www.rubydoc.info/gems/rack/Rack/Utils#HTTP_STATUS_CODES-constant
+//
+// ```
+// curl -s https://www.iana.org/assignments/http-status-codes/http-status-codes-1.csv | \
+// ruby -ne 'm = /^(\d{3}),(?!Unassigned|\(Unused\))([^,]+)/.match($_) and \
+// puts "_#{m[1]}_#{m[2].delete %Q[ ]} = #{m[1]},"'
+// ```
 export const HttpStatus = {
   /*
    * 1xx informational response
@@ -102,5 +105,6 @@ export const HttpStatus = {
    */
 
   // A deprecated response used by the Spring Framework when a method has failed
+  // Still in use at PMU as of 2022
   _420_MethodFailure: 420
 } as const;