typedrest 0.4.1 → 0.5.0

package/errors/DefaultErrorHandler.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultErrorHandler = void 0;
 const Errors_1 = require("./Errors");
@@ -26,26 +17,25 @@ class DefaultErrorHandler {
      * @throws {@link errors!TimeoutError}: {@link http!HttpStatusCode.RequestTimeout}
      * @throws {@link errors!ConflictError}: {@link http!HttpStatusCode.Conflict}
      * @throws {@link errors!ConcurrencyError}: {@link http!HttpStatusCode.PreconditionFailed}
+     * @throws {@link errors!RangeNotSatisfiableError}: {@link http!HttpStatusCode.RangeNotSatisfiable}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    handle(response) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            if (response.ok)
-                return;
-            const contentType = response.headers.get(http_1.HttpHeader.ContentType);
-            let jsonBody;
-            if ((contentType === null || contentType === void 0 ? void 0 : contentType.startsWith("application/json")) || (contentType === null || contentType === void 0 ? void 0 : contentType.includes("+json"))) {
-                try {
-                    jsonBody = yield response.json();
-                }
-                catch (_c) {
-                    jsonBody = undefined;
-                }
+    async handle(response) {
+        var _a, _b;
+        if (response.ok)
+            return;
+        const contentType = response.headers.get(http_1.HttpHeader.ContentType);
+        let jsonBody;
+        if ((contentType === null || contentType === void 0 ? void 0 : contentType.startsWith("application/json")) || (contentType === null || contentType === void 0 ? void 0 : contentType.includes("+json"))) {
+            try {
+                jsonBody = await response.json();
             }
-            const errorType = DefaultErrorHandler.errorType(response.status);
-            throw new errorType((_b = (_a = jsonBody === null || jsonBody === void 0 ? void 0 : jsonBody.message) !== null && _a !== void 0 ? _a : jsonBody === null || jsonBody === void 0 ? void 0 : jsonBody.details) !== null && _b !== void 0 ? _b : `HTTP ${response.status} ${response.statusText}`, response.status, jsonBody);
-        });
+            catch (_c) {
+                jsonBody = undefined;
+            }
+        }
+        const errorType = DefaultErrorHandler.errorType(response.status);
+        throw new errorType((_b = (_a = jsonBody === null || jsonBody === void 0 ? void 0 : jsonBody.message) !== null && _a !== void 0 ? _a : jsonBody === null || jsonBody === void 0 ? void 0 : jsonBody.details) !== null && _b !== void 0 ? _b : `HTTP ${response.status} ${response.statusText}`, response.status, jsonBody);
     }
     static errorType(status) {
         switch (status) {
@@ -64,10 +54,12 @@ class DefaultErrorHandler {
                 return Errors_1.ConflictError;
             case http_1.HttpStatusCode.PreconditionFailed:
                 return Errors_1.ConcurrencyError;
+            case http_1.HttpStatusCode.RangeNotSatisfiable:
+                return Errors_1.RangeNotSatisfiableError;
             default:
                 return Errors_1.HttpError;
         }
     }
 }
 exports.DefaultErrorHandler = DefaultErrorHandler;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRGVmYXVsdEVycm9ySGFuZGxlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIkRlZmF1bHRFcnJvckhhbmRsZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7O0FBQ0EscUNBQTZKO0FBQzdKLGtDQUFxRDtBQUVyRDs7R0FFRztBQUNILE1BQWEsbUJBQW1CO0lBQzVCOzs7Ozs7Ozs7OztPQVdHO0lBQ0csTUFBTSxDQUFDLFFBQWtCOzs7WUFDM0IsSUFBSSxRQUFRLENBQUMsRUFBRTtnQkFBRSxPQUFPO1lBRXhCLE1BQU0sV0FBVyxHQUFHLFFBQVEsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLGlCQUFVLENBQUMsV0FBVyxDQUFDLENBQUM7WUFDakUsSUFBSSxRQUFhLENBQUM7WUFDbEIsSUFBSSxDQUFBLFdBQVcsYUFBWCxXQUFXLHVCQUFYLFdBQVcsQ0FBRSxVQUFVLENBQUMsa0JBQWtCLENBQUMsTUFBSSxXQUFXLGFBQVgsV0FBVyx1QkFBWCxXQUFXLENBQUUsUUFBUSxDQUFDLE9BQU8sQ0FBQyxDQUFBLEVBQUUsQ0FBQztnQkFDaEYsSUFBSSxDQUFDO29CQUNELFFBQVEsR0FBRyxNQUFNLFFBQVEsQ0FBQyxJQUFJLEVBQUUsQ0FBQztnQkFDckMsQ0FBQztnQkFBQyxXQUFNLENBQUM7b0JBQ0wsUUFBUSxHQUFHLFNBQVMsQ0FBQztnQkFDekIsQ0FBQztZQUNMLENBQUM7WUFFRCxNQUFNLFNBQVMsR0FBRyxtQkFBbUIsQ0FBQyxTQUFTLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFDO1lBQ2pFLE1BQU0sSUFBSSxTQUFTLENBQ2YsTUFBQSxNQUFBLFFBQVEsYUFBUixRQUFRLHVCQUFSLFFBQVEsQ0FBRSxPQUFPLG1DQUFJLFFBQVEsYUFBUixRQUFRLHVCQUFSLFFBQVEsQ0FBRSxPQUFPLG1DQUFJLFFBQVEsUUFBUSxDQUFDLE1BQU0sSUFBSSxRQUFRLENBQUMsVUFBVSxFQUFFLEVBQzFGLFFBQVEsQ0FBQyxNQUFNLEVBQ2YsUUFBUSxDQUFDLENBQUM7UUFDbEIsQ0FBQztLQUFBO0lBRU8sTUFBTSxDQUFDLFNBQVMsQ0FBQyxNQUFzQjtRQUMzQyxRQUFRLE1BQU0sRUFBRSxDQUFDO1lBQ2IsS0FBSyxxQkFBYyxDQUFDLFVBQVU7Z0JBQzFCLE9BQU8sd0JBQWUsQ0FBQztZQUMzQixLQUFLLHFCQUFjLENBQUMsWUFBWTtnQkFDNUIsT0FBTyw0QkFBbUIsQ0FBQztZQUMvQixLQUFLLHFCQUFjLENBQUMsU0FBUztnQkFDekIsT0FBTywyQkFBa0IsQ0FBQztZQUM5QixLQUFLLHFCQUFjLENBQUMsUUFBUSxDQUFDO1lBQzdCLEtBQUsscUJBQWMsQ0FBQyxJQUFJO2dCQUNwQixPQUFPLHNCQUFhLENBQUM7WUFDekIsS0FBSyxxQkFBYyxDQUFDLGNBQWM7Z0JBQzlCLE9BQU8scUJBQVksQ0FBQztZQUN4QixLQUFLLHFCQUFjLENBQUMsUUFBUTtnQkFDeEIsT0FBTyxzQkFBYSxDQUFDO1lBQ3pCLEtBQUsscUJBQWMsQ0FBQyxrQkFBa0I7Z0JBQ2xDLE9BQU8seUJBQWdCLENBQUM7WUFDNUI7Z0JBQ0ksT0FBTyxrQkFBUyxDQUFDO1FBQ3pCLENBQUM7SUFDTCxDQUFDO0NBQ0o7QUF0REQsa0RBc0RDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRGVmYXVsdEVycm9ySGFuZGxlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIkRlZmF1bHRFcnJvckhhbmRsZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQ0EscUNBQXVMO0FBQ3ZMLGtDQUFxRDtBQUVyRDs7R0FFRztBQUNILE1BQWEsbUJBQW1CO0lBQzVCOzs7Ozs7Ozs7Ozs7T0FZRztJQUNILEtBQUssQ0FBQyxNQUFNLENBQUMsUUFBa0I7O1FBQzNCLElBQUksUUFBUSxDQUFDLEVBQUU7WUFBRSxPQUFPO1FBRXhCLE1BQU0sV0FBVyxHQUFHLFFBQVEsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLGlCQUFVLENBQUMsV0FBVyxDQUFDLENBQUM7UUFDakUsSUFBSSxRQUFhLENBQUM7UUFDbEIsSUFBSSxDQUFBLFdBQVcsYUFBWCxXQUFXLHVCQUFYLFdBQVcsQ0FBRSxVQUFVLENBQUMsa0JBQWtCLENBQUMsTUFBSSxXQUFXLGFBQVgsV0FBVyx1QkFBWCxXQUFXLENBQUUsUUFBUSxDQUFDLE9BQU8sQ0FBQyxDQUFBLEVBQUUsQ0FBQztZQUNoRixJQUFJLENBQUM7Z0JBQ0QsUUFBUSxHQUFHLE1BQU0sUUFBUSxDQUFDLElBQUksRUFBRSxDQUFDO1lBQ3JDLENBQUM7WUFBQyxXQUFNLENBQUM7Z0JBQ0wsUUFBUSxHQUFHLFNBQVMsQ0FBQztZQUN6QixDQUFDO1FBQ0wsQ0FBQztRQUVELE1BQU0sU0FBUyxHQUFHLG1CQUFtQixDQUFDLFNBQVMsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDakUsTUFBTSxJQUFJLFNBQVMsQ0FDZixNQUFBLE1BQUEsUUFBUSxhQUFSLFFBQVEsdUJBQVIsUUFBUSxDQUFFLE9BQU8sbUNBQUksUUFBUSxhQUFSLFFBQVEsdUJBQVIsUUFBUSxDQUFFLE9BQU8sbUNBQUksUUFBUSxRQUFRLENBQUMsTUFBTSxJQUFJLFFBQVEsQ0FBQyxVQUFVLEVBQUUsRUFDMUYsUUFBUSxDQUFDLE1BQU0sRUFDZixRQUFRLENBQUMsQ0FBQztJQUNsQixDQUFDO0lBRU8sTUFBTSxDQUFDLFNBQVMsQ0FBQyxNQUFzQjtRQUMzQyxRQUFRLE1BQU0sRUFBRSxDQUFDO1lBQ2IsS0FBSyxxQkFBYyxDQUFDLFVBQVU7Z0JBQzFCLE9BQU8sd0JBQWUsQ0FBQztZQUMzQixLQUFLLHFCQUFjLENBQUMsWUFBWTtnQkFDNUIsT0FBTyw0QkFBbUIsQ0FBQztZQUMvQixLQUFLLHFCQUFjLENBQUMsU0FBUztnQkFDekIsT0FBTywyQkFBa0IsQ0FBQztZQUM5QixLQUFLLHFCQUFjLENBQUMsUUFBUSxDQUFDO1lBQzdCLEtBQUsscUJBQWMsQ0FBQyxJQUFJO2dCQUNwQixPQUFPLHNCQUFhLENBQUM7WUFDekIsS0FBSyxxQkFBYyxDQUFDLGNBQWM7Z0JBQzlCLE9BQU8scUJBQVksQ0FBQztZQUN4QixLQUFLLHFCQUFjLENBQUMsUUFBUTtnQkFDeEIsT0FBTyxzQkFBYSxDQUFDO1lBQ3pCLEtBQUsscUJBQWMsQ0FBQyxrQkFBa0I7Z0JBQ2xDLE9BQU8seUJBQWdCLENBQUM7WUFDNUIsS0FBSyxxQkFBYyxDQUFDLG1CQUFtQjtnQkFDbkMsT0FBTyxpQ0FBd0IsQ0FBQztZQUNwQztnQkFDSSxPQUFPLGtCQUFTLENBQUM7UUFDekIsQ0FBQztJQUNMLENBQUM7Q0FDSjtBQXpERCxrREF5REMifQ==

package/errors/DefaultErrorHandler.ts

@@ -1,5 +1,5 @@
 import { ErrorHandler } from "./ErrorHandler";
-import { HttpError, BadRequestError, AuthenticationError, AuthorizationError, NotFoundError, TimeoutError, ConflictError, ConcurrencyError } from "./Errors";
+import { HttpError, BadRequestError, AuthenticationError, AuthorizationError, NotFoundError, TimeoutError, ConflictError, ConcurrencyError, RangeNotSatisfiableError } from "./Errors";
 import { HttpStatusCode, HttpHeader } from "../http";
 
 /**
@@ -16,6 +16,7 @@ export class DefaultErrorHandler implements ErrorHandler {
      * @throws {@link errors!TimeoutError}: {@link http!HttpStatusCode.RequestTimeout}
      * @throws {@link errors!ConflictError}: {@link http!HttpStatusCode.Conflict}
      * @throws {@link errors!ConcurrencyError}: {@link http!HttpStatusCode.PreconditionFailed}
+     * @throws {@link errors!RangeNotSatisfiableError}: {@link http!HttpStatusCode.RangeNotSatisfiable}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
     async handle(response: Response) {
@@ -55,6 +56,8 @@ export class DefaultErrorHandler implements ErrorHandler {
                 return ConflictError;
             case HttpStatusCode.PreconditionFailed:
                 return ConcurrencyError;
+            case HttpStatusCode.RangeNotSatisfiable:
+                return RangeNotSatisfiableError;
             default:
                 return HttpError;
         }

package/errors/Errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConcurrencyError = exports.ConflictError = exports.TimeoutError = exports.NotFoundError = exports.AuthorizationError = exports.AuthenticationError = exports.BadRequestError = exports.HttpError = void 0;
+exports.RangeNotSatisfiableError = exports.ConcurrencyError = exports.ConflictError = exports.TimeoutError = exports.NotFoundError = exports.AuthorizationError = exports.AuthenticationError = exports.BadRequestError = exports.HttpError = void 0;
 /**
  * Thrown on HTTP response with a non-successful status code (4xx or 5xx).
  */
@@ -60,4 +60,10 @@ exports.ConflictError = ConflictError;
 class ConcurrencyError extends HttpError {
 }
 exports.ConcurrencyError = ConcurrencyError;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiRXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUVBOztHQUVHO0FBQ0gsTUFBYSxTQUFVLFNBQVEsS0FBSztJQUNoQzs7Ozs7T0FLRztJQUNILFlBQVksT0FBZSxFQUFTLE1BQXNCLEVBQVMsSUFBVTtRQUN6RSxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFEaUIsV0FBTSxHQUFOLE1BQU0sQ0FBZ0I7UUFBUyxTQUFJLEdBQUosSUFBSSxDQUFNO0lBRTdFLENBQUM7Q0FDSjtBQVZELDhCQVVDO0FBRUQ7O0dBRUc7QUFDSCxNQUFhLGVBQWdCLFNBQVEsU0FBUztDQUFHO0FBQWpELDBDQUFpRDtBQUVqRDs7R0FFRztBQUNILE1BQWEsbUJBQW9CLFNBQVEsU0FBUztDQUFHO0FBQXJELGtEQUFxRDtBQUVyRDs7R0FFRztBQUNILE1BQWEsa0JBQW1CLFNBQVEsU0FBUztDQUFHO0FBQXBELGdEQUFvRDtBQUVwRDs7R0FFRztBQUNILE1BQWEsYUFBYyxTQUFRLFNBQVM7Q0FBRztBQUEvQyxzQ0FBK0M7QUFFL0M7O0dBRUc7QUFDSCxNQUFhLFlBQWEsU0FBUSxTQUFTO0NBQUc7QUFBOUMsb0NBQThDO0FBRTlDOztHQUVHO0FBQ0gsTUFBYSxhQUFjLFNBQVEsU0FBUztDQUFHO0FBQS9DLHNDQUErQztBQUUvQzs7R0FFRztBQUNILE1BQWEsZ0JBQWlCLFNBQVEsU0FBUztDQUFHO0FBQWxELDRDQUFrRCJ9
+/**
+ * Thrown on HTTP response for a requested range that the server can not provide (usually {@link http!HttpStatusCode.RangeNotSatisfiable}).
+ */
+class RangeNotSatisfiableError extends HttpError {
+}
+exports.RangeNotSatisfiableError = RangeNotSatisfiableError;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiRXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUVBOztHQUVHO0FBQ0gsTUFBYSxTQUFVLFNBQVEsS0FBSztJQUNoQzs7Ozs7T0FLRztJQUNILFlBQVksT0FBZSxFQUFTLE1BQXNCLEVBQVMsSUFBVTtRQUN6RSxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFEaUIsV0FBTSxHQUFOLE1BQU0sQ0FBZ0I7UUFBUyxTQUFJLEdBQUosSUFBSSxDQUFNO0lBRTdFLENBQUM7Q0FDSjtBQVZELDhCQVVDO0FBRUQ7O0dBRUc7QUFDSCxNQUFhLGVBQWdCLFNBQVEsU0FBUztDQUFHO0FBQWpELDBDQUFpRDtBQUVqRDs7R0FFRztBQUNILE1BQWEsbUJBQW9CLFNBQVEsU0FBUztDQUFHO0FBQXJELGtEQUFxRDtBQUVyRDs7R0FFRztBQUNILE1BQWEsa0JBQW1CLFNBQVEsU0FBUztDQUFHO0FBQXBELGdEQUFvRDtBQUVwRDs7R0FFRztBQUNILE1BQWEsYUFBYyxTQUFRLFNBQVM7Q0FBRztBQUEvQyxzQ0FBK0M7QUFFL0M7O0dBRUc7QUFDSCxNQUFhLFlBQWEsU0FBUSxTQUFTO0NBQUc7QUFBOUMsb0NBQThDO0FBRTlDOztHQUVHO0FBQ0gsTUFBYSxhQUFjLFNBQVEsU0FBUztDQUFHO0FBQS9DLHNDQUErQztBQUUvQzs7R0FFRztBQUNILE1BQWEsZ0JBQWlCLFNBQVEsU0FBUztDQUFHO0FBQWxELDRDQUFrRDtBQUVsRDs7R0FFRztBQUNILE1BQWEsd0JBQXlCLFNBQVEsU0FBUztDQUFHO0FBQTFELDREQUEwRCJ9

package/errors/Errors.ts

@@ -49,3 +49,8 @@ export class ConflictError extends HttpError {}
  * Thrown on HTTP response for a failed precondition or mid-air collision (usually {@link http!HttpStatusCode.PreconditionFailed}).
  */
 export class ConcurrencyError extends HttpError {}
+
+/**
+ * Thrown on HTTP response for a requested range that the server can not provide (usually {@link http!HttpStatusCode.RangeNotSatisfiable}).
+ */
+export class RangeNotSatisfiableError extends HttpError {}

package/http/EntityStream.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entityStream = entityStream;
+/**
+ * Exposes the body of a `Response` as a stream of deserialized entities.
+ * @typeParam TEntity The type of entity the stream provides.
+ * @param response The response to read the body from.
+ * @param serializer Controls the deserialization of the entities in the body.
+ * @param separator The character sequence used to detect that a new entity starts in the stream.
+ * @returns A stream that ends when the server closes the connection.
+ */
+async function* entityStream(response, serializer, separator = "\n") {
+    if (!response.body)
+        return;
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let index;
+            while ((index = buffer.indexOf(separator)) !== -1) {
+                const entity = buffer.slice(0, index);
+                buffer = buffer.slice(index + separator.length);
+                if (entity.trim())
+                    yield serializer.deserialize(entity);
+            }
+        }
+        // Tolerate a missing separator after the last entity
+        buffer += decoder.decode();
+        if (buffer.trim())
+            yield serializer.deserialize(buffer);
+    }
+    finally {
+        // NOTE: Ignore errors here so that a failure that already ended the stream is not masked.
+        await reader.cancel().catch(() => { });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRW50aXR5U3RyZWFtLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiRW50aXR5U3RyZWFtLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBVUEsb0NBNkJDO0FBckNEOzs7Ozs7O0dBT0c7QUFDSSxLQUFLLFNBQVMsQ0FBQyxDQUFDLFlBQVksQ0FBVSxRQUFrQixFQUFFLFVBQXNCLEVBQUUsWUFBb0IsSUFBSTtJQUM3RyxJQUFJLENBQUMsUUFBUSxDQUFDLElBQUk7UUFBRSxPQUFPO0lBRTNCLE1BQU0sTUFBTSxHQUFHLFFBQVEsQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLENBQUM7SUFDekMsTUFBTSxPQUFPLEdBQUcsSUFBSSxXQUFXLEVBQUUsQ0FBQztJQUNsQyxJQUFJLE1BQU0sR0FBRyxFQUFFLENBQUM7SUFFaEIsSUFBSSxDQUFDO1FBQ0QsT0FBTyxJQUFJLEVBQUUsQ0FBQztZQUNWLE1BQU0sRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLEdBQUcsTUFBTSxNQUFNLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDNUMsSUFBSSxJQUFJO2dCQUFFLE1BQU07WUFFaEIsTUFBTSxJQUFJLE9BQU8sQ0FBQyxNQUFNLENBQUMsS0FBSyxFQUFFLEVBQUUsTUFBTSxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7WUFFbEQsSUFBSSxLQUFhLENBQUM7WUFDbEIsT0FBTyxDQUFDLEtBQUssR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDaEQsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsS0FBSyxDQUFDLENBQUM7Z0JBQ3RDLE1BQU0sR0FBRyxNQUFNLENBQUMsS0FBSyxDQUFDLEtBQUssR0FBRyxTQUFTLENBQUMsTUFBTSxDQUFDLENBQUM7Z0JBQ2hELElBQUksTUFBTSxDQUFDLElBQUksRUFBRTtvQkFBRSxNQUFNLFVBQVUsQ0FBQyxXQUFXLENBQVUsTUFBTSxDQUFDLENBQUM7WUFDckUsQ0FBQztRQUNMLENBQUM7UUFFRCxxREFBcUQ7UUFDckQsTUFBTSxJQUFJLE9BQU8sQ0FBQyxNQUFNLEVBQUUsQ0FBQztRQUMzQixJQUFJLE1BQU0sQ0FBQyxJQUFJLEVBQUU7WUFBRSxNQUFNLFVBQVUsQ0FBQyxXQUFXLENBQVUsTUFBTSxDQUFDLENBQUM7SUFDckUsQ0FBQztZQUFTLENBQUM7UUFDUCwwRkFBMEY7UUFDMUYsTUFBTSxNQUFNLENBQUMsTUFBTSxFQUFFLENBQUMsS0FBSyxDQUFDLEdBQUcsRUFBRSxHQUFHLENBQUMsQ0FBQyxDQUFDO0lBQzNDLENBQUM7QUFDTCxDQUFDIn0=

package/http/EntityStream.ts

@@ -0,0 +1,40 @@
+import { Serializer } from "../serializers";
+
+/**
+ * Exposes the body of a `Response` as a stream of deserialized entities.
+ * @typeParam TEntity The type of entity the stream provides.
+ * @param response The response to read the body from.
+ * @param serializer Controls the deserialization of the entities in the body.
+ * @param separator The character sequence used to detect that a new entity starts in the stream.
+ * @returns A stream that ends when the server closes the connection.
+ */
+export async function* entityStream<TEntity>(response: Response, serializer: Serializer, separator: string = "\n"): AsyncIterableIterator<TEntity> {
+    if (!response.body) return;
+
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+
+            buffer += decoder.decode(value, { stream: true });
+
+            let index: number;
+            while ((index = buffer.indexOf(separator)) !== -1) {
+                const entity = buffer.slice(0, index);
+                buffer = buffer.slice(index + separator.length);
+                if (entity.trim()) yield serializer.deserialize<TEntity>(entity);
+            }
+        }
+
+        // Tolerate a missing separator after the last entity
+        buffer += decoder.decode();
+        if (buffer.trim()) yield serializer.deserialize<TEntity>(buffer);
+    } finally {
+        // NOTE: Ignore errors here so that a failure that already ended the stream is not masked.
+        await reader.cancel().catch(() => { });
+    }
+}

package/http/HttpContentRange.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpContentRange = void 0;
+const HttpHeader_1 = require("./HttpHeader");
+/**
+ * Describes which subset of a set of elements a response contains.
+ */
+class HttpContentRange {
+    /**
+     * Creates a new content range.
+     * @param unit The unit the range is expressed in, e.g. `elements`.
+     * @param from The index at which the data starts.
+     * @param to The index at which the data stops.
+     * @param length The total number of elements available on the server; `undefined` if unknown.
+     */
+    constructor(unit, from, to, length) {
+        this.unit = unit;
+        this.from = from;
+        this.to = to;
+        this.length = length;
+    }
+    /**
+     * Extracts the content range from a `Response`.
+     * @returns The content range; `undefined` if the response has no (valid) {@link HttpHeader.ContentRange} header.
+     */
+    static from(response) {
+        const header = response.headers.get(HttpHeader_1.HttpHeader.ContentRange);
+        if (!header)
+            return undefined;
+        const match = HttpContentRange.pattern.exec(header.trim());
+        if (!match)
+            return undefined;
+        const [, unit, from, to, length] = match;
+        return new HttpContentRange(unit, from === undefined ? undefined : parseInt(from), to === undefined ? undefined : parseInt(to), length === "*" ? undefined : parseInt(length));
+    }
+}
+exports.HttpContentRange = HttpContentRange;
+HttpContentRange.pattern = /^(\w+) (?:(\d+)-(\d+)|\*)\/(\d+|\*)$/;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSHR0cENvbnRlbnRSYW5nZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIkh0dHBDb250ZW50UmFuZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsNkNBQTBDO0FBRTFDOztHQUVHO0FBQ0gsTUFBYSxnQkFBZ0I7SUFDekI7Ozs7OztPQU1HO0lBQ0gsWUFDb0IsSUFBWSxFQUNaLElBQWEsRUFDYixFQUFXLEVBQ1gsTUFBZTtRQUhmLFNBQUksR0FBSixJQUFJLENBQVE7UUFDWixTQUFJLEdBQUosSUFBSSxDQUFTO1FBQ2IsT0FBRSxHQUFGLEVBQUUsQ0FBUztRQUNYLFdBQU0sR0FBTixNQUFNLENBQVM7SUFDbkMsQ0FBQztJQUlEOzs7T0FHRztJQUNILE1BQU0sQ0FBQyxJQUFJLENBQUMsUUFBa0I7UUFDMUIsTUFBTSxNQUFNLEdBQUcsUUFBUSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsdUJBQVUsQ0FBQyxZQUFZLENBQUMsQ0FBQztRQUM3RCxJQUFJLENBQUMsTUFBTTtZQUFFLE9BQU8sU0FBUyxDQUFDO1FBRTlCLE1BQU0sS0FBSyxHQUFHLGdCQUFnQixDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksRUFBRSxDQUFDLENBQUM7UUFDM0QsSUFBSSxDQUFDLEtBQUs7WUFBRSxPQUFPLFNBQVMsQ0FBQztRQUU3QixNQUFNLENBQUMsRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLEVBQUUsRUFBRSxNQUFNLENBQUMsR0FBRyxLQUFLLENBQUM7UUFDekMsT0FBTyxJQUFJLGdCQUFnQixDQUN2QixJQUFJLEVBQ0osSUFBSSxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLEVBQy9DLEVBQUUsS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQyxFQUMzQyxNQUFNLEtBQUssR0FBRyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDO0lBQ3ZELENBQUM7O0FBbENMLDRDQW1DQztBQXBCMkIsd0JBQU8sR0FBRyxzQ0FBc0MsQ0FBQyJ9

package/http/HttpContentRange.ts

@@ -0,0 +1,41 @@
+import { HttpHeader } from "./HttpHeader";
+
+/**
+ * Describes which subset of a set of elements a response contains.
+ */
+export class HttpContentRange {
+    /**
+     * Creates a new content range.
+     * @param unit The unit the range is expressed in, e.g. `elements`.
+     * @param from The index at which the data starts.
+     * @param to The index at which the data stops.
+     * @param length The total number of elements available on the server; `undefined` if unknown.
+     */
+    constructor(
+        public readonly unit: string,
+        public readonly from?: number,
+        public readonly to?: number,
+        public readonly length?: number) {
+    }
+
+    private static readonly pattern = /^(\w+) (?:(\d+)-(\d+)|\*)\/(\d+|\*)$/;
+
+    /**
+     * Extracts the content range from a `Response`.
+     * @returns The content range; `undefined` if the response has no (valid) {@link HttpHeader.ContentRange} header.
+     */
+    static from(response: Response): HttpContentRange | undefined {
+        const header = response.headers.get(HttpHeader.ContentRange);
+        if (!header) return undefined;
+
+        const match = HttpContentRange.pattern.exec(header.trim());
+        if (!match) return undefined;
+
+        const [, unit, from, to, length] = match;
+        return new HttpContentRange(
+            unit,
+            from === undefined ? undefined : parseInt(from),
+            to === undefined ? undefined : parseInt(to),
+            length === "*" ? undefined : parseInt(length));
+    }
+}

package/http/HttpHeader.js

@@ -12,5 +12,10 @@ var HttpHeader;
     HttpHeader["ETag"] = "ETag";
     HttpHeader["IfMatch"] = "If-Match";
     HttpHeader["IfNoneMatch"] = "If-None-Match";
+    HttpHeader["Range"] = "Range";
+    HttpHeader["ContentRange"] = "Content-Range";
+    HttpHeader["AcceptRanges"] = "Accept-Ranges";
+    HttpHeader["RetryAfter"] = "Retry-After";
+    HttpHeader["LastEventId"] = "Last-Event-ID";
 })(HttpHeader || (exports.HttpHeader = HttpHeader = {}));
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSHR0cEhlYWRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIkh0dHBIZWFkZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsSUFBWSxVQVVYO0FBVkQsV0FBWSxVQUFVO0lBQ2xCLDZDQUErQixDQUFBO0lBQy9CLDBDQUE0QixDQUFBO0lBQzVCLCtCQUFpQixDQUFBO0lBQ2pCLDZCQUFlLENBQUE7SUFDZixtQ0FBcUIsQ0FBQTtJQUNyQiwyQkFBYSxDQUFBO0lBQ2IsMkJBQWEsQ0FBQTtJQUNiLGtDQUFvQixDQUFBO0lBQ3BCLDJDQUE2QixDQUFBO0FBQ2pDLENBQUMsRUFWVyxVQUFVLDBCQUFWLFVBQVUsUUFVckIifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSHR0cEhlYWRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIkh0dHBIZWFkZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsSUFBWSxVQWVYO0FBZkQsV0FBWSxVQUFVO0lBQ2xCLDZDQUErQixDQUFBO0lBQy9CLDBDQUE0QixDQUFBO0lBQzVCLCtCQUFpQixDQUFBO0lBQ2pCLDZCQUFlLENBQUE7SUFDZixtQ0FBcUIsQ0FBQTtJQUNyQiwyQkFBYSxDQUFBO0lBQ2IsMkJBQWEsQ0FBQTtJQUNiLGtDQUFvQixDQUFBO0lBQ3BCLDJDQUE2QixDQUFBO0lBQzdCLDZCQUFlLENBQUE7SUFDZiw0Q0FBOEIsQ0FBQTtJQUM5Qiw0Q0FBOEIsQ0FBQTtJQUM5Qix3Q0FBMEIsQ0FBQTtJQUMxQiwyQ0FBNkIsQ0FBQTtBQUNqQyxDQUFDLEVBZlcsVUFBVSwwQkFBVixVQUFVLFFBZXJCIn0=

package/http/HttpHeader.ts

@@ -7,5 +7,10 @@ export enum HttpHeader {
     Link = "Link",
     ETag = "ETag",
     IfMatch = "If-Match",
-    IfNoneMatch = "If-None-Match"
+    IfNoneMatch = "If-None-Match",
+    Range = "Range",
+    ContentRange = "Content-Range",
+    AcceptRanges = "Accept-Ranges",
+    RetryAfter = "Retry-After",
+    LastEventId = "Last-Event-ID"
 }

package/http/HttpStatusCode.js

@@ -6,6 +6,8 @@ var HttpStatusCode;
     HttpStatusCode[HttpStatusCode["OK"] = 200] = "OK";
     HttpStatusCode[HttpStatusCode["Created"] = 201] = "Created";
     HttpStatusCode[HttpStatusCode["Accepted"] = 202] = "Accepted";
+    HttpStatusCode[HttpStatusCode["NoContent"] = 204] = "NoContent";
+    HttpStatusCode[HttpStatusCode["PartialContent"] = 206] = "PartialContent";
     HttpStatusCode[HttpStatusCode["NotModified"] = 304] = "NotModified";
     HttpStatusCode[HttpStatusCode["BadRequest"] = 400] = "BadRequest";
     HttpStatusCode[HttpStatusCode["Unauthorized"] = 401] = "Unauthorized";
@@ -15,5 +17,6 @@ var HttpStatusCode;
     HttpStatusCode[HttpStatusCode["Conflict"] = 409] = "Conflict";
     HttpStatusCode[HttpStatusCode["Gone"] = 410] = "Gone";
     HttpStatusCode[HttpStatusCode["PreconditionFailed"] = 412] = "PreconditionFailed";
+    HttpStatusCode[HttpStatusCode["RangeNotSatisfiable"] = 416] = "RangeNotSatisfiable";
 })(HttpStatusCode || (exports.HttpStatusCode = HttpStatusCode = {}));
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSHR0cFN0YXR1c0NvZGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJIdHRwU3RhdHVzQ29kZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxJQUFZLGNBYVg7QUFiRCxXQUFZLGNBQWM7SUFDdEIsaURBQVEsQ0FBQTtJQUNSLDJEQUFhLENBQUE7SUFDYiw2REFBYyxDQUFBO0lBQ2QsbUVBQWlCLENBQUE7SUFDakIsaUVBQWdCLENBQUE7SUFDaEIscUVBQWtCLENBQUE7SUFDbEIsK0RBQWUsQ0FBQTtJQUNmLDZEQUFjLENBQUE7SUFDZCx5RUFBb0IsQ0FBQTtJQUNwQiw2REFBYyxDQUFBO0lBQ2QscURBQVUsQ0FBQTtJQUNWLGlGQUF3QixDQUFBO0FBQzVCLENBQUMsRUFiVyxjQUFjLDhCQUFkLGNBQWMsUUFhekIifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSHR0cFN0YXR1c0NvZGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJIdHRwU3RhdHVzQ29kZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxJQUFZLGNBZ0JYO0FBaEJELFdBQVksY0FBYztJQUN0QixpREFBUSxDQUFBO0lBQ1IsMkRBQWEsQ0FBQTtJQUNiLDZEQUFjLENBQUE7SUFDZCwrREFBZSxDQUFBO0lBQ2YseUVBQW9CLENBQUE7SUFDcEIsbUVBQWlCLENBQUE7SUFDakIsaUVBQWdCLENBQUE7SUFDaEIscUVBQWtCLENBQUE7SUFDbEIsK0RBQWUsQ0FBQTtJQUNmLDZEQUFjLENBQUE7SUFDZCx5RUFBb0IsQ0FBQTtJQUNwQiw2REFBYyxDQUFBO0lBQ2QscURBQVUsQ0FBQTtJQUNWLGlGQUF3QixDQUFBO0lBQ3hCLG1GQUF5QixDQUFBO0FBQzdCLENBQUMsRUFoQlcsY0FBYyw4QkFBZCxjQUFjLFFBZ0J6QiJ9

package/http/HttpStatusCode.ts

@@ -2,6 +2,8 @@ export enum HttpStatusCode {
     OK = 200,
     Created = 201,
     Accepted = 202,
+    NoContent = 204,
+    PartialContent = 206,
     NotModified = 304,
     BadRequest = 400,
     Unauthorized = 401,
@@ -10,5 +12,6 @@ export enum HttpStatusCode {
     RequestTimeout = 408,
     Conflict = 409,
     Gone = 410,
-    PreconditionFailed = 412
+    PreconditionFailed = 412,
+    RangeNotSatisfiable = 416
 }

package/http/ResponseCache.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResponseCache = void 0;
 const HttpHeader_1 = require("./HttpHeader");
@@ -29,12 +20,10 @@ class ResponseCache {
     /**
      * Creates a new cache from a `Response`.
      */
-    static from(response) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            return new ResponseCache(yield response.text(), (_a = response.headers.get(HttpHeader_1.HttpHeader.ContentType)) !== null && _a !== void 0 ? _a : undefined, (_b = response.headers.get(HttpHeader_1.HttpHeader.ETag)) !== null && _b !== void 0 ? _b : undefined);
-        });
+    static async from(response) {
+        var _a, _b;
+        return new ResponseCache(await response.text(), (_a = response.headers.get(HttpHeader_1.HttpHeader.ContentType)) !== null && _a !== void 0 ? _a : undefined, (_b = response.headers.get(HttpHeader_1.HttpHeader.ETag)) !== null && _b !== void 0 ? _b : undefined);
     }
 }
 exports.ResponseCache = ResponseCache;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUmVzcG9uc2VDYWNoZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIlJlc3BvbnNlQ2FjaGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7O0FBQUEsNkNBQTBDO0FBRTFDOztHQUVHO0FBQ0gsTUFBYSxhQUFhO0lBQ3RCOzs7OztPQUtHO0lBQ0gsWUFBNEIsT0FBZSxFQUFrQixXQUFvQixFQUFrQixJQUFhO1FBQXBGLFlBQU8sR0FBUCxPQUFPLENBQVE7UUFBa0IsZ0JBQVcsR0FBWCxXQUFXLENBQVM7UUFBa0IsU0FBSSxHQUFKLElBQUksQ0FBUztJQUNoSCxDQUFDO0lBRUQ7O09BRUc7SUFDSCxNQUFNLENBQU8sSUFBSSxDQUFDLFFBQWtCOzs7WUFDaEMsT0FBTyxJQUFJLGFBQWEsQ0FDcEIsTUFBTSxRQUFRLENBQUMsSUFBSSxFQUFFLEVBQ3JCLE1BQUEsUUFBUSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsdUJBQVUsQ0FBQyxXQUFXLENBQUMsbUNBQUksU0FBUyxFQUN6RCxNQUFBLFFBQVEsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLHVCQUFVLENBQUMsSUFBSSxDQUFDLG1DQUFJLFNBQVMsQ0FBQyxDQUFDO1FBQzVELENBQUM7S0FBQTtDQUNKO0FBbkJELHNDQW1CQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUmVzcG9uc2VDYWNoZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIlJlc3BvbnNlQ2FjaGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsNkNBQTBDO0FBRTFDOztHQUVHO0FBQ0gsTUFBYSxhQUFhO0lBQ3RCOzs7OztPQUtHO0lBQ0gsWUFBNEIsT0FBZSxFQUFrQixXQUFvQixFQUFrQixJQUFhO1FBQXBGLFlBQU8sR0FBUCxPQUFPLENBQVE7UUFBa0IsZ0JBQVcsR0FBWCxXQUFXLENBQVM7UUFBa0IsU0FBSSxHQUFKLElBQUksQ0FBUztJQUNoSCxDQUFDO0lBRUQ7O09BRUc7SUFDSCxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxRQUFrQjs7UUFDaEMsT0FBTyxJQUFJLGFBQWEsQ0FDcEIsTUFBTSxRQUFRLENBQUMsSUFBSSxFQUFFLEVBQ3JCLE1BQUEsUUFBUSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsdUJBQVUsQ0FBQyxXQUFXLENBQUMsbUNBQUksU0FBUyxFQUN6RCxNQUFBLFFBQVEsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLHVCQUFVLENBQUMsSUFBSSxDQUFDLG1DQUFJLFNBQVMsQ0FBQyxDQUFDO0lBQzVELENBQUM7Q0FDSjtBQW5CRCxzQ0FtQkMifQ==

package/http/RetryAfter.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retryAfter = retryAfter;
+const HttpHeader_1 = require("./HttpHeader");
+/**
+ * Extracts the delay a server has asked clients to wait for before retrying a request.
+ * @param response The response to read the {@link HttpHeader.RetryAfter} header from.
+ * @returns The delay in milliseconds; `undefined` if the response has no (valid) header.
+ */
+function retryAfter(response) {
+    var _a;
+    const header = (_a = response.headers.get(HttpHeader_1.HttpHeader.RetryAfter)) === null || _a === void 0 ? void 0 : _a.trim();
+    if (!header)
+        return undefined;
+    // Either a number of seconds ...
+    if (/^\d+$/.test(header))
+        return parseInt(header) * 1000;
+    // ... or an absolute point in time
+    const date = Date.parse(header);
+    if (Number.isNaN(date))
+        return undefined;
+    return Math.max(0, date - Date.now());
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUmV0cnlBZnRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIlJldHJ5QWZ0ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFPQSxnQ0FXQztBQWxCRCw2Q0FBMEM7QUFFMUM7Ozs7R0FJRztBQUNILFNBQWdCLFVBQVUsQ0FBQyxRQUFrQjs7SUFDekMsTUFBTSxNQUFNLEdBQUcsTUFBQSxRQUFRLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyx1QkFBVSxDQUFDLFVBQVUsQ0FBQywwQ0FBRSxJQUFJLEVBQUUsQ0FBQztJQUNuRSxJQUFJLENBQUMsTUFBTTtRQUFFLE9BQU8sU0FBUyxDQUFDO0lBRTlCLGlDQUFpQztJQUNqQyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDO1FBQUUsT0FBTyxRQUFRLENBQUMsTUFBTSxDQUFDLEdBQUcsSUFBSSxDQUFDO0lBRXpELG1DQUFtQztJQUNuQyxNQUFNLElBQUksR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ2hDLElBQUksTUFBTSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUM7UUFBRSxPQUFPLFNBQVMsQ0FBQztJQUN6QyxPQUFPLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxFQUFFLElBQUksR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQztBQUMxQyxDQUFDIn0=

package/http/RetryAfter.ts

@@ -0,0 +1,19 @@
+import { HttpHeader } from "./HttpHeader";
+
+/**
+ * Extracts the delay a server has asked clients to wait for before retrying a request.
+ * @param response The response to read the {@link HttpHeader.RetryAfter} header from.
+ * @returns The delay in milliseconds; `undefined` if the response has no (valid) header.
+ */
+export function retryAfter(response: Response): number | undefined {
+    const header = response.headers.get(HttpHeader.RetryAfter)?.trim();
+    if (!header) return undefined;
+
+    // Either a number of seconds ...
+    if (/^\d+$/.test(header)) return parseInt(header) * 1000;
+
+    // ... or an absolute point in time
+    const date = Date.parse(header);
+    if (Number.isNaN(date)) return undefined;
+    return Math.max(0, date - Date.now());
+}

package/http/ServerSentEvents.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseReader = exports.defaultEventType = exports.ServerSentEvent = void 0;
+/**
+ * Yields the lines terminated by `\n`, `\r\n` or `\r` within the first `limit` characters of `buffer`.
+ * @returns The remaining characters that are not part of a terminated line.
+ */
+function* splitLines(buffer, limit) {
+    let start = 0;
+    for (let index = 0; index < limit; index++) {
+        const char = buffer[index];
+        if (char !== "\n" && char !== "\r")
+            continue;
+        yield buffer.slice(start, index);
+        if (char === "\r" && buffer[index + 1] === "\n")
+            index++;
+        start = index + 1;
+    }
+    return buffer.slice(start);
+}
+/**
+ * A single event read from a Server-Sent Events (SSE) stream.
+ */
+class ServerSentEvent {
+    /**
+     * Creates a new event.
+     * @param type The event type from the `event:` field. {@link defaultEventType} if the server did not specify one.
+     * @param data The concatenated content of the event's `data:` fields.
+     * @param id The id of the most recent `id:` field if any.
+     */
+    constructor(type, data, id) {
+        this.type = type;
+        this.data = data;
+        this.id = id;
+    }
+}
+exports.ServerSentEvent = ServerSentEvent;
+/**
+ * The event type used for events without an explicit `event:` field.
+ */
+exports.defaultEventType = "message";
+/**
+ * Reads {@link ServerSentEvent}s from the body of a `Response` in the `text/event-stream` format.
+ */
+class SseReader {
+    /**
+     * Creates a new reader.
+     * @param response The response to read the body from.
+     */
+    constructor(response) {
+        this.response = response;
+    }
+    /**
+     * The id of the most recent event that carried an `id:` field.<br>
+     * Send this back as a {@link HttpHeader.LastEventId} header when reconnecting to let the server resume where it left off.
+     */
+    get lastEventId() { return this._lastEventId; }
+    /**
+     * The reconnection interval in milliseconds most recently requested by the server via a `retry:` field if any.
+     */
+    get reconnectionInterval() { return this._reconnectionInterval; }
+    /**
+     * Reads events until the stream ends.<br>
+     * Any event that is still incomplete when the stream ends is discarded.
+     */
+    async *events() {
+        let type;
+        let data = "";
+        for await (const line of this.lines()) {
+            if (line === "") {
+                // A blank line dispatches the event collected so far
+                if (data !== "") {
+                    // Every data field appended a trailing newline; the last one is not part of the payload
+                    yield new ServerSentEvent(type !== null && type !== void 0 ? type : exports.defaultEventType, data.slice(0, -1), this._lastEventId);
+                    data = "";
+                }
+                type = undefined;
+                continue;
+            }
+            // Lines starting with a colon are comments, e.g. the ":ping" some servers send to keep the connection alive
+            if (line.startsWith(":"))
+                continue;
+            const colonIndex = line.indexOf(":");
+            const field = (colonIndex === -1) ? line : line.slice(0, colonIndex);
+            const value = (colonIndex === -1) ? ""
+                : line.slice((line[colonIndex + 1] === " ") ? colonIndex + 2 : colonIndex + 1);
+            switch (field) {
+                case "event":
+                    type = value;
+                    break;
+                case "data":
+                    data += value + "\n";
+                    break;
+                case "id":
+                    if (value.indexOf("\0") === -1)
+                        this._lastEventId = value;
+                    break;
+                case "retry":
+                    if (/^\d+$/.test(value))
+                        this._reconnectionInterval = parseInt(value);
+                    break;
+            }
+        }
+    }
+    /**
+     * Splits the response body into lines, accepting `\n`, `\r\n` and `\r` as terminators.
+     */
+    async *lines() {
+        if (!this.response.body)
+            return;
+        const reader = this.response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        let stripBom = true;
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                if (stripBom && buffer !== "") {
+                    if (buffer.charCodeAt(0) === 0xFEFF)
+                        buffer = buffer.slice(1);
+                    stripBom = false;
+                }
+                // NOTE: Keep a trailing "\r" buffered; it may still be followed by a "\n" in the next chunk.
+                buffer = yield* splitLines(buffer, buffer.endsWith("\r") ? buffer.length - 1 : buffer.length);
+            }
+            // NOTE: A line that is still unterminated once the stream ends is discarded.
+            buffer += decoder.decode();
+            yield* splitLines(buffer, buffer.length);
+        }
+        finally {
+            // NOTE: Ignore errors here so that a failure that already ended the stream is not masked.
+            await reader.cancel().catch(() => { });
+        }
+    }
+}
+exports.SseReader = SseReader;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiU2VydmVyU2VudEV2ZW50cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIlNlcnZlclNlbnRFdmVudHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUE7OztHQUdHO0FBQ0gsUUFBUSxDQUFDLENBQUMsVUFBVSxDQUFDLE1BQWMsRUFBRSxLQUFhO0lBQzlDLElBQUksS0FBSyxHQUFHLENBQUMsQ0FBQztJQUVkLEtBQUssSUFBSSxLQUFLLEdBQUcsQ0FBQyxFQUFFLEtBQUssR0FBRyxLQUFLLEVBQUUsS0FBSyxFQUFFLEVBQUUsQ0FBQztRQUN6QyxNQUFNLElBQUksR0FBRyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDM0IsSUFBSSxJQUFJLEtBQUssSUFBSSxJQUFJLElBQUksS0FBSyxJQUFJO1lBQUUsU0FBUztRQUU3QyxNQUFNLE1BQU0sQ0FBQyxLQUFLLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQ2pDLElBQUksSUFBSSxLQUFLLElBQUksSUFBSSxNQUFNLENBQUMsS0FBSyxHQUFHLENBQUMsQ0FBQyxLQUFLLElBQUk7WUFBRSxLQUFLLEVBQUUsQ0FBQztRQUN6RCxLQUFLLEdBQUcsS0FBSyxHQUFHLENBQUMsQ0FBQztJQUN0QixDQUFDO0lBRUQsT0FBTyxNQUFNLENBQUMsS0FBSyxDQUFDLEtBQUssQ0FBQyxDQUFDO0FBQy9CLENBQUM7QUFFRDs7R0FFRztBQUNILE1BQWEsZUFBZTtJQUN4Qjs7Ozs7T0FLRztJQUNILFlBQTRCLElBQVksRUFBa0IsSUFBWSxFQUFrQixFQUFXO1FBQXZFLFNBQUksR0FBSixJQUFJLENBQVE7UUFBa0IsU0FBSSxHQUFKLElBQUksQ0FBUTtRQUFrQixPQUFFLEdBQUYsRUFBRSxDQUFTO0lBQ25HLENBQUM7Q0FDSjtBQVRELDBDQVNDO0FBRUQ7O0dBRUc7QUFDVSxRQUFBLGdCQUFnQixHQUFHLFNBQVMsQ0FBQztBQUUxQzs7R0FFRztBQUNILE1BQWEsU0FBUztJQUNsQjs7O09BR0c7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