typedrest 0.4.0 → 0.5.0

package/endpoints/generic/GenericCollectionEndpoint.js

@@ -1,16 +1,8 @@
 "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.GenericCollectionEndpoint = void 0;
 const ETagEndpointBase_1 = require("./ETagEndpointBase");
+const PartialResponse_1 = require("./PartialResponse");
 const http_1 = require("../../http");
 /**
  * Endpoint for a collection of `TEntity`s addressable as `TElementEndpoint`s.<br>
@@ -28,6 +20,12 @@ class GenericCollectionEndpoint extends ETagEndpointBase_1.ETagEndpointBase {
     constructor(referrer, relativeUri, elementEndpoint) {
         super(referrer, relativeUri);
         this.elementEndpoint = elementEndpoint;
+        /**
+         * The unit used when requesting ranges of elements. Sent in the {@link http!HttpHeader.Range} header.
+         */
+        this.rangeUnit = "elements";
+        // NOTE: Only modified when the server reports its capabilities.
+        this.acceptedRangeUnits = [];
         this.setDefaultLinkTemplate("child", "./{id}");
     }
     /**
@@ -64,10 +62,44 @@ class GenericCollectionEndpoint extends ETagEndpointBase_1.ETagEndpointBase {
      * @throws {@link errors!ConflictError}: {@link http!HttpStatusCode.Conflict}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    readAll(signal) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.serializer.deserialize(yield this.getContent(signal));
+    async readAll(signal) {
+        return this.serializer.deserialize(await this.getContent(signal));
+    }
+    /**
+     * @inheritDoc
+     */
+    handleCapabilities(response) {
+        super.handleCapabilities(response);
+        const header = response.headers.get(http_1.HttpHeader.AcceptRanges);
+        if (header) {
+            this.acceptedRangeUnits = header.split(",").map(x => x.trim());
+        }
+    }
+    /**
+     * Shows whether the server has indicated that {@link readRange} is currently allowed.
+     * Uses cached data from last response.
+     * @returns `true` if the method is allowed, `false` if the method is not allowed, `undefined` if no request has been sent yet or the server did not specify accepted range units.
+     */
+    get readRangeAllowed() {
+        if (this.acceptedRangeUnits.length === 0)
+            return undefined;
+        return this.acceptedRangeUnits.indexOf(this.rangeUnit) !== -1;
+    }
+    /**
+     * Returns a subset of the `TEntity`s in the collection.
+     * @param from The index of the first element to return. Leave unspecified to return the last `to` elements ("tail").
+     * @param to The index of the last element to return. Leave unspecified to return all elements starting at `from`.
+     * @param signal Used to cancel the request.
+     * @throws {@link errors!AuthenticationError}: {@link http!HttpStatusCode.Unauthorized}
+     * @throws {@link errors!AuthorizationError}: {@link http!HttpStatusCode.Forbidden}
+     * @throws {@link errors!RangeNotSatisfiableError}: {@link http!HttpStatusCode.RangeNotSatisfiable}, i.e. the requested range lies outside of the elements currently available
+     * @throws {@link errors!HttpError}: Other non-success status code
+     */
+    async readRange(from, to, signal) {
+        const response = await this.send(http_1.HttpMethod.Get, signal, {
+            [http_1.HttpHeader.Range]: `${this.rangeUnit}=${from !== null && from !== void 0 ? from : ""}-${to !== null && to !== void 0 ? to : ""}`
         });
+        return new PartialResponse_1.PartialResponse(this.serializer.deserialize(await response.text()), http_1.HttpContentRange.from(response));
     }
     /**
      * Shows whether the server has indicated that {@link create} is currently allowed.
@@ -86,30 +118,28 @@ class GenericCollectionEndpoint extends ETagEndpointBase_1.ETagEndpointBase {
      * @throws {@link errors!ConflictError}: {@link http!HttpStatusCode.Conflict}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    create(entity, signal) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.send(http_1.HttpMethod.Post, signal, {
-                [http_1.HttpHeader.ContentType]: this.serializer.supportedMediaTypes[0]
-            }, this.serializer.serialize(entity));
-            const location = response.headers.get(http_1.HttpHeader.Location);
-            let elementEndpoint;
-            if (location) {
-                // Explicit element endpoint URL from "Location" header
-                elementEndpoint = new this.elementEndpoint(this, this.join(location));
+    async create(entity, signal) {
+        const response = await this.send(http_1.HttpMethod.Post, signal, {
+            [http_1.HttpHeader.ContentType]: this.serializer.supportedMediaTypes[0]
+        }, this.serializer.serialize(entity));
+        const location = response.headers.get(http_1.HttpHeader.Location);
+        let elementEndpoint;
+        if (location) {
+            // Explicit element endpoint URL from "Location" header
+            elementEndpoint = new this.elementEndpoint(this, this.join(location));
+        }
+        else {
+            try {
+                // Infer URL from entity ID in response body
+                elementEndpoint = this.get(this.serializer.deserialize(await response.clone().text()));
             }
-            else {
-                try {
-                    // Infer URL from entity ID in response body
-                    elementEndpoint = this.get(this.serializer.deserialize(yield response.clone().text()));
-                }
-                catch (_a) {
-                    // No element endpoint
-                    return undefined;
-                }
+            catch (_a) {
+                // No element endpoint
+                return undefined;
             }
-            elementEndpoint.responseCache = yield http_1.ResponseCache.from(response);
-            return elementEndpoint;
-        });
+        }
+        elementEndpoint.responseCache = await http_1.ResponseCache.from(response);
+        return elementEndpoint;
     }
     /**
      * Shows whether the server has indicated that {@link createAll} is currently allowed.
@@ -127,12 +157,10 @@ class GenericCollectionEndpoint extends ETagEndpointBase_1.ETagEndpointBase {
      * @throws {@link errors!ConflictError}: {@link http!HttpStatusCode.Conflict}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    createAll(entities, signal) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.send(http_1.HttpMethod.Patch, signal, {
-                [http_1.HttpHeader.ContentType]: this.serializer.supportedMediaTypes[0]
-            }, this.serializer.serialize(entities));
-        });
+    async createAll(entities, signal) {
+        await this.send(http_1.HttpMethod.Patch, signal, {
+            [http_1.HttpHeader.ContentType]: this.serializer.supportedMediaTypes[0]
+        }, this.serializer.serialize(entities));
     }
     /**
      * Shows whether the server has indicated that {@link setAll} is currently allowed.
@@ -149,9 +177,7 @@ class GenericCollectionEndpoint extends ETagEndpointBase_1.ETagEndpointBase {
      * @throws {@link errors!ConflictError}: {@link http!HttpStatusCode.Conflict}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    setAll(entities) {
-        return __awaiter(this, void 0, void 0, function* () { yield this.putContent(entities); });
-    }
+    async setAll(entities) { await this.putContent(entities); }
     /**
      * Determines whether the collection contains a specific element.
      * @param element The ID identifying the entity or an entity to extract the ID from.
@@ -193,4 +219,4 @@ class GenericCollectionEndpoint extends ETagEndpointBase_1.ETagEndpointBase {
     delete(element) { return this.get(element).delete(); }
 }
 exports.GenericCollectionEndpoint = GenericCollectionEndpoint;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR2VuZXJpY0NvbGxlY3Rpb25FbmRwb2ludC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIkdlbmVyaWNDb2xsZWN0aW9uRW5kcG9pbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7O0FBQUEseURBQXNEO0FBSXRELHFDQUFtRTtBQUVuRTs7Ozs7R0FLRztBQUNILE1BQWEseUJBQXNGLFNBQVEsbUNBQWdCO0lBQ3ZIOzs7OztPQUtHO0lBQ0gsWUFBWSxRQUFrQixFQUFFLFdBQXlCLEVBQW1CLGVBQXVFO1FBQy9JLEtBQUssQ0FBQyxRQUFRLEVBQUUsV0FBVyxDQUFDLENBQUM7UUFEMkMsb0JBQWUsR0FBZixlQUFlLENBQXdEO1FBRS9JLElBQUksQ0FBQyxzQkFBc0IsQ0FBQyxPQUFPLEVBQUUsUUFBUSxDQUFDLENBQUM7SUFDbkQsQ0FBQztJQUVEOzs7T0FHRztJQUNILEdBQUcsQ0FBQyxPQUEyQjtRQUMzQixJQUFJLE9BQU8sSUFBSSxJQUFJO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQywwQ0FBMEMsQ0FBQyxDQUFDO1FBRWpGLElBQUksRUFBVSxDQUFDO1FBQ2YsSUFBSSxPQUFPLE9BQU8sS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUM5QixFQUFFLEdBQUcsT0FBTyxDQUFDO1FBQ2pCLENBQUM7YUFBTSxDQUFDO1lBQ0osRUFBRSxHQUFJLE9BQWUsQ0FBQyxFQUFFLENBQUM7WUFDekIsSUFBSSxFQUFFLEtBQUssU0FBUztnQkFBRSxNQUFNLElBQUksS0FBSyxDQUFDLFdBQVcsT0FBTyxnQ0FBZ0MsQ0FBQyxDQUFDO1FBQzlGLENBQUM7UUFDRCxJQUFJLEVBQUUsSUFBSSxJQUFJLElBQUksRUFBRSxLQUFLLEVBQUU7WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLCtCQUErQixDQUFDLENBQUM7UUFFOUUsT0FBTyxJQUFJLElBQUksQ0FBQyxlQUFlLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxZQUFZLENBQUMsT0FBTyxFQUFFLEVB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR2VuZXJpY0NvbGxlY3Rpb25FbmRwb2ludC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIkdlbmVyaWNDb2xsZWN0aW9uRW5kcG9pbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEseURBQXNEO0FBRXRELHVEQUFvRDtBQUdwRCxxQ0FBcUY7QUFFckY7Ozs7O0dBS0c7QUFDSCxNQUFhLHlCQUFzRixTQUFRLG1DQUFnQjtJQUN2SDs7Ozs7T0FLRztJQUNILFlBQVksUUFBa0IsRUFBRSxXQUF5QixFQUFtQixlQUF1RTtRQUMvSSxLQUFLLENBQUMsUUFBUSxFQUFFLFdBQVcsQ0FBQyxDQUFDO1FBRDJDLG9CQUFlLEdBQWYsZUFBZSxDQUF3RDtRQTJDbko7O1dBRUc7UUFDSCxjQUFTLEdBQUcsVUFBVSxDQUFDO1FBRXZCLGdFQUFnRTtRQUN4RCx1QkFBa0IsR0FBYSxFQUFFLENBQUM7UUEvQ3RDLElBQUksQ0FBQyxzQkFBc0IsQ0FBQyxPQUFPLEVBQUUsUUFBUSxDQUFDLENBQUM7SUFDbkQsQ0FBQztJQUVEOzs7T0FHRztJQUNILEdBQUcsQ0FBQyxPQUEyQjtRQUMzQixJQUFJLE9BQU8sSUFBSSxJQUFJO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQywwQ0FBMEMsQ0FBQyxDQUFDO1FBRWpGLElBQUksRUFBVSxDQUFDO1FBQ2YsSUFBSSxPQUFPLE9BQU8sS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUM5QixFQUFFLEdBQUcsT0FBTyxDQUFDO1FBQ2pCLENBQUM7YUFBTSxDQUFDO1lBQ0osRUFBRSxHQUFJLE9BQWUsQ0FBQyxFQUFFLENBQUM7WUFDekIsSUFBSSxFQUFFLEtBQUssU0FBUztnQkFBRSxNQUFNLElBQUksS0FBSyxDQUFDLFdBQVcsT0FBTyxnQ0FBZ0MsQ0FBQyxDQUFDO1FBQzlGLENBQUM7UUFDRCxJQUFJLEVBQUUsSUFBSSxJQUFJLElBQUksRUFBRSxLQUFLLEVBQUU7WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLCtCQUErQixDQUFD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

package/endpoints/generic/GenericCollectionEndpoint.test.ts

@@ -0,0 +1,123 @@
+/**
+ * NOTE: The jsdom environment strips the "Range" request header, so these tests need the node environment.
+ * @jest-environment node
+ */
+
+import fetchMock from 'jest-fetch-mock';
+import { CollectionEndpoint } from '.';
+import { EntryEndpoint } from '..';
+import { HttpHeader, HttpStatusCode, HttpContentRange } from '../../http';
+import { RangeNotSatisfiableError } from '../../errors';
+
+class MockEntity {
+    constructor(public id: number, public name: string) { }
+}
+
+fetchMock.enableMocks();
+let endpoint: CollectionEndpoint<MockEntity>;
+
+beforeEach(() => {
+    fetchMock.resetMocks();
+    endpoint = new CollectionEndpoint(new EntryEndpoint('http://localhost/'), 'endpoint');
+});
+
+test('readRange', async () => {
+    fetchMock.mockOnceIf(
+        'http://localhost/endpoint',
+        async req => {
+            expect(req.headers.get(HttpHeader.Range)).toBe('elements=1-2');
+            return {
+                body: '[{"id":6,"name":"test2"}, {"id":7,"name":"test3"}]',
+                status: HttpStatusCode.PartialContent,
+                headers: {
+                    [HttpHeader.ContentRange]: 'elements 1-2/3'
+                }
+            };
+        }
+    );
+
+    const result = await endpoint.readRange(1, 2);
+    expect(result.elements).toEqual([new MockEntity(6, 'test2'), new MockEntity(7, 'test3')]);
+    expect(result.range).toEqual(new HttpContentRange('elements', 1, 2, 3));
+    expect(result.endReached).toBe(true);
+});
+
+test('readRangeOffset', async () => {
+    fetchMock.mockOnceIf(
+        'http://localhost/endpoint',
+        async req => {
+            expect(req.headers.get(HttpHeader.Range)).toBe('elements=1-');
+            return {
+                body: '[{"id":6,"name":"test2"}]',
+                status: HttpStatusCode.PartialContent,
+                headers: {
+                    [HttpHeader.ContentRange]: 'elements 1-1/*'
+                }
+            };
+        }
+    );
+
+    const result = await endpoint.readRange(1);
+    expect(result.elements).toEqual([new MockEntity(6, 'test2')]);
+    expect(result.range).toEqual(new HttpContentRange('elements', 1, 1, undefined));
+    expect(result.endReached).toBe(false);
+});
+
+test('readRangeTail', async () => {
+    fetchMock.mockOnceIf(
+        'http://localhost/endpoint',
+        async req => {
+            expect(req.headers.get(HttpHeader.Range)).toBe('elements=-1');
+            return {
+                body: '[{"id":6,"name":"test2"}]',
+                status: HttpStatusCode.PartialContent
+            };
+        }
+    );
+
+    const result = await endpoint.readRange(undefined, 1);
+    expect(result.elements).toEqual([new MockEntity(6, 'test2')]);
+    expect(result.range).toBeUndefined();
+    expect(result.endReached).toBe(true);
+});
+
+test('readRangeNotSatisfiable', async () => {
+    fetchMock.mockOnceIf(
+        'http://localhost/endpoint',
+        async () => ({ status: HttpStatusCode.RangeNotSatisfiable })
+    );
+
+    await expect(endpoint.readRange(1)).rejects.toThrow(RangeNotSatisfiableError);
+});
+
+test('readRangeAllowed', async () => {
+    expect(endpoint.readRangeAllowed).toBeUndefined();
+
+    fetchMock.mockOnceIf(
+        'http://localhost/endpoint',
+        '[]',
+        {
+            headers: {
+                [HttpHeader.AcceptRanges]: 'elements'
+            }
+        }
+    );
+    await endpoint.readAll();
+
+    expect(endpoint.readRangeAllowed).toBe(true);
+});
+
+test('readRangeNotAllowed', async () => {
+    fetchMock.mockOnceIf(
+        'http://localhost/endpoint',
+        '[]',
+        {
+            headers: {
+                [HttpHeader.AcceptRanges]: 'none'
+            }
+        }
+    );
+    await endpoint.readAll();
+
+    expect(endpoint.readRangeAllowed).toBe(false);
+});

package/endpoints/generic/GenericCollectionEndpoint.ts

@@ -1,8 +1,9 @@
 import { ETagEndpointBase } from "./ETagEndpointBase";
 import { ElementEndpoint } from "./ElementEndpoint";
+import { PartialResponse } from "./PartialResponse";
 import { Endpoint } from "../Endpoint";
 import { CachingEndpoint } from "../CachingEndpoint";
-import { HttpMethod, HttpHeader, ResponseCache } from "../../http";
+import { HttpMethod, HttpHeader, HttpContentRange, ResponseCache } from "../../http";
 
 /**
  * Endpoint for a collection of `TEntity`s addressable as `TElementEndpoint`s.<br>
@@ -60,6 +61,58 @@ export class GenericCollectionEndpoint<TEntity, TElementEndpoint extends Element
         return this.serializer.deserialize<TEntity[]>(await this.getContent(signal));
     }
 
+    /**
+     * The unit used when requesting ranges of elements. Sent in the {@link http!HttpHeader.Range} header.
+     */
+    rangeUnit = "elements";
+
+    // NOTE: Only modified when the server reports its capabilities.
+    private acceptedRangeUnits: string[] = [];
+
+    /**
+     * @inheritDoc
+     */
+    protected handleCapabilities(response: Response) {
+        super.handleCapabilities(response);
+
+        const header = response.headers.get(HttpHeader.AcceptRanges);
+        if (header) {
+            this.acceptedRangeUnits = header.split(",").map(x => x.trim());
+        }
+    }
+
+    /**
+     * Shows whether the server has indicated that {@link readRange} is currently allowed.
+     * Uses cached data from last response.
+     * @returns `true` if the method is allowed, `false` if the method is not allowed, `undefined` if no request has been sent yet or the server did not specify accepted range units.
+     */
+    get readRangeAllowed(): boolean | undefined {
+        if (this.acceptedRangeUnits.length === 0)
+            return undefined;
+
+        return this.acceptedRangeUnits.indexOf(this.rangeUnit) !== -1;
+    }
+
+    /**
+     * Returns a subset of the `TEntity`s in the collection.
+     * @param from The index of the first element to return. Leave unspecified to return the last `to` elements ("tail").
+     * @param to The index of the last element to return. Leave unspecified to return all elements starting at `from`.
+     * @param signal Used to cancel the request.
+     * @throws {@link errors!AuthenticationError}: {@link http!HttpStatusCode.Unauthorized}
+     * @throws {@link errors!AuthorizationError}: {@link http!HttpStatusCode.Forbidden}
+     * @throws {@link errors!RangeNotSatisfiableError}: {@link http!HttpStatusCode.RangeNotSatisfiable}, i.e. the requested range lies outside of the elements currently available
+     * @throws {@link errors!HttpError}: Other non-success status code
+     */
+    async readRange(from?: number, to?: number, signal?: AbortSignal): Promise<PartialResponse<TEntity>> {
+        const response = await this.send(HttpMethod.Get, signal, {
+            [HttpHeader.Range]: `${this.rangeUnit}=${from ?? ""}-${to ?? ""}`
+        });
+
+        return new PartialResponse<TEntity>(
+            this.serializer.deserialize<TEntity[]>(await response.text()),
+            HttpContentRange.from(response));
+    }
+
     /**
      * Shows whether the server has indicated that {@link create} is currently allowed.
      * Uses cached data from last response.

package/endpoints/generic/PartialResponse.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartialResponse = void 0;
+/**
+ * Represents a subset of a set of elements.
+ * @typeParam TEntity The type of element the response contains.
+ */
+class PartialResponse {
+    /**
+     * Creates a new partial response.
+     * @param elements The returned elements.
+     * @param range The range the `elements` come from.
+     */
+    constructor(elements, range) {
+        this.elements = elements;
+        this.range = range;
+    }
+    /**
+     * Indicates whether the response reaches the end of the elements available on the server.
+     */
+    get endReached() {
+        var _a;
+        // No range specified, must be complete response
+        if (((_a = this.range) === null || _a === void 0 ? void 0 : _a.to) === undefined)
+            return true;
+        // No length specified, can't be the end
+        if (this.range.length === undefined)
+            return false;
+        return this.range.to === this.range.length - 1;
+    }
+}
+exports.PartialResponse = PartialResponse;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUGFydGlhbFJlc3BvbnNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiUGFydGlhbFJlc3BvbnNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUVBOzs7R0FHRztBQUNILE1BQWEsZUFBZTtJQUN4Qjs7OztPQUlHO0lBQ0gsWUFBNEIsUUFBbUIsRUFBa0IsS0FBd0I7UUFBN0QsYUFBUSxHQUFSLFFBQVEsQ0FBVztRQUFrQixVQUFLLEdBQUwsS0FBSyxDQUFtQjtJQUN6RixDQUFDO0lBRUQ7O09BRUc7SUFDSCxJQUFJLFVBQVU7O1FBQ1YsZ0RBQWdEO1FBQ2hELElBQUksQ0FBQSxNQUFBLElBQUksQ0FBQyxLQUFLLDBDQUFFLEVBQUUsTUFBSyxTQUFTO1lBQUUsT0FBTyxJQUFJLENBQUM7UUFFOUMsd0NBQXdDO1FBQ3hDLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLEtBQUssU0FBUztZQUFFLE9BQU8sS0FBSyxDQUFDO1FBRWxELE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FBQyxFQUFFLEtBQUssSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDO0lBQ25ELENBQUM7Q0FDSjtBQXJCRCwwQ0FxQkMifQ==

package/endpoints/generic/PartialResponse.ts

@@ -0,0 +1,28 @@
+import { HttpContentRange } from "../../http";
+
+/**
+ * Represents a subset of a set of elements.
+ * @typeParam TEntity The type of element the response contains.
+ */
+export class PartialResponse<TEntity> {
+    /**
+     * Creates a new partial response.
+     * @param elements The returned elements.
+     * @param range The range the `elements` come from.
+     */
+    constructor(public readonly elements: TEntity[], public readonly range?: HttpContentRange) {
+    }
+
+    /**
+     * Indicates whether the response reaches the end of the elements available on the server.
+     */
+    get endReached(): boolean {
+        // No range specified, must be complete response
+        if (this.range?.to === undefined) return true;
+
+        // No length specified, can't be the end
+        if (this.range.length === undefined) return false;
+
+        return this.range.to === this.range.length - 1;
+    }
+}

package/endpoints/generic/index.js

@@ -16,7 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./IndexerEndpoint"), exports);
 __exportStar(require("./ETagEndpointBase"), exports);
+__exportStar(require("./PartialResponse"), exports);
 __exportStar(require("./GenericCollectionEndpoint"), exports);
 __exportStar(require("./CollectionEndpoint"), exports);
 __exportStar(require("./ElementEndpoint"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsb0RBQWtDO0FBQ2xDLHFEQUFtQztBQUNuQyw4REFBNEM7QUFDNUMsdURBQXFDO0FBQ3JDLG9EQUFrQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsb0RBQWtDO0FBQ2xDLHFEQUFtQztBQUNuQyxvREFBa0M7QUFDbEMsOERBQTRDO0FBQzVDLHVEQUFxQztBQUNyQyxvREFBa0MifQ==

package/endpoints/generic/index.ts

@@ -1,5 +1,6 @@
 export * from "./IndexerEndpoint";
 export * from "./ETagEndpointBase";
+export * from "./PartialResponse";
 export * from "./GenericCollectionEndpoint";
 export * from "./CollectionEndpoint";
 export * from "./ElementEndpoint";

package/endpoints/index.js

@@ -36,11 +36,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.raw = exports.rpc = exports.generic = void 0;
+exports.reactive = exports.raw = exports.rpc = exports.generic = void 0;
 exports.generic = __importStar(require("./generic"));
 exports.rpc = __importStar(require("./rpc"));
 exports.raw = __importStar(require("./raw"));
+exports.reactive = __importStar(require("./reactive"));
 __exportStar(require("./Endpoint"), exports);
 __exportStar(require("./EntryEndpoint"), exports);
 __exportStar(require("./CachingEndpoint"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxxREFBcUM7QUFDckMsNkNBQTZCO0FBQzdCLDZDQUE2QjtBQUU3Qiw2Q0FBMkI7QUFDM0Isa0RBQWdDO0FBQ2hDLG9EQUFrQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxxREFBcUM7QUFDckMsNkNBQTZCO0FBQzdCLDZDQUE2QjtBQUM3Qix1REFBdUM7QUFFdkMsNkNBQTJCO0FBQzNCLGtEQUFnQztBQUNoQyxvREFBa0MifQ==

package/endpoints/index.ts

@@ -1,6 +1,7 @@
 export * as generic from "./generic";
 export * as rpc from "./rpc";
 export * as raw from "./raw";
+export * as reactive from "./reactive";
 
 export * from "./Endpoint";
 export * from "./EntryEndpoint";

package/endpoints/raw/BlobEndpoint.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.BlobEndpoint = void 0;
 const Endpoint_1 = require("../Endpoint");
@@ -32,10 +23,8 @@ class BlobEndpoint extends Endpoint_1.Endpoint {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    probe(signal) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.send(http_1.HttpMethod.Options, signal);
-        });
+    async probe(signal) {
+        await this.send(http_1.HttpMethod.Options, signal);
     }
     /**
      * Shows whether the server has indicated that {@link download} is currently allowed.
@@ -52,11 +41,9 @@ class BlobEndpoint extends Endpoint_1.Endpoint {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    download(signal) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.send(http_1.HttpMethod.Get, signal);
-            return response.blob();
-        });
+    async download(signal) {
+        const response = await this.send(http_1.HttpMethod.Get, signal);
+        return response.blob();
     }
     /**
      * Shows whether the server has indicated that {@link upload} is currently allowed.
@@ -73,10 +60,8 @@ class BlobEndpoint extends Endpoint_1.Endpoint {
      * @throws {@link errors!AuthorizationError}: {@link http!HttpStatusCode.Forbidden}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    uploadFrom(blob, signal) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.send(http_1.HttpMethod.Put, signal, { [http_1.HttpHeader.ContentType]: blob.type }, blob);
-        });
+    async uploadFrom(blob, signal) {
+        await this.send(http_1.HttpMethod.Put, signal, { [http_1.HttpHeader.ContentType]: blob.type }, blob);
     }
     /**
      * Shows whether the server has indicated that {@link delete} is currently allowed.
@@ -93,11 +78,9 @@ class BlobEndpoint extends Endpoint_1.Endpoint {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    delete(signal) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.send(http_1.HttpMethod.Delete, signal);
-        });
+    async delete(signal) {
+        await this.send(http_1.HttpMethod.Delete, signal);
     }
 }
 exports.BlobEndpoint = BlobEndpoint;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQmxvYkVuZHBvaW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiQmxvYkVuZHBvaW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7OztBQUFBLDBDQUF1QztBQUN2QyxxQ0FBb0Q7QUFFcEQ7O0dBRUc7QUFDSCxNQUFhLFlBQWEsU0FBUSxtQkFBUTtJQUN0Qzs7OztPQUlHO0lBQ0gsWUFBWSxRQUFrQixFQUFFLFdBQXlCO1FBQ3JELEtBQUssQ0FBQyxRQUFRLEVBQUUsV0FBVyxDQUFDLENBQUM7SUFDakMsQ0FBQztJQUVEOzs7Ozs7O09BT0c7SUFDRyxLQUFLLENBQUMsTUFBb0I7O1lBQzVCLE1BQU0sSUFBSSxDQUFDLElBQUksQ0FBQyxpQkFBVSxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQztRQUNoRCxDQUFDO0tBQUE7SUFFRDs7OztPQUlHO0lBQ0gsSUFBSSxlQUFlLEtBQUssT0FBTyxJQUFJLENBQUMsZUFBZSxDQUFDLGlCQUFVLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBRXRFOzs7Ozs7OztPQVFHO0lBQ0csUUFBUSxDQUFDLE1BQW9COztZQUMvQixNQUFNLFFBQVEsR0FBRyxNQUFNLElBQUksQ0FBQyxJQUFJLENBQUMsaUJBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxDQUFDLENBQUM7WUFDekQsT0FBTyxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDM0IsQ0FBQztLQUFBO0lBRUQ7Ozs7T0FJRztJQUNILElBQUksYUFBYSxLQUFLLE9BQU8sSUFBSSxDQUFDLGVBQWUsQ0FBQyxpQkFBVSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUVwRTs7Ozs7Ozs7T0FRRztJQUNHLFVBQVUsQ0FBQyxJQUFVLEVBQUUsTUFBb0I7O1lBQzdDLE1BQU0sSUFBSSxDQUFDLElBQUksQ0FBQyxpQkFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEVBQUUsRUFBRSxDQUFDLGlCQUFVLENBQUMsV0FBVyxDQUFDLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRSxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQzNGLENBQUM7S0FBQTtJQUVEOzs7O09BSUc7SUFDSCxJQUFJLGFBQWEsS0FBSyxPQUFPLElBQUksQ0FBQyxlQUFlLENBQUMsaUJBQVUsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFFdkU7Ozs7Ozs7O09BUUc7SUFDRyxNQUFNLENBQUMsTUFBb0I7O1lBQzdCLE1BQU0sSUFBSSxDQUFDLElBQUksQ0FBQyxpQkFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLENBQUMsQ0FBQztRQUMvQyxDQUFDO0tBQUE7Q0FDSjtBQWxGRCxvQ0FrRkMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQmxvYkVuZHBvaW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiQmxvYkVuZHBvaW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDBDQUF1QztBQUN2QyxxQ0FBb0Q7QUFFcEQ7O0dBRUc7QUFDSCxNQUFhLFlBQWEsU0FBUSxtQkFBUTtJQUN0Qzs7OztPQUlHO0lBQ0gsWUFBWSxRQUFrQixFQUFFLFdBQXlCO1FBQ3JELEtBQUssQ0FBQyxRQUFRLEVBQUUsV0FBVyxDQUFDLENBQUM7SUFDakMsQ0FBQztJQUVEOzs7Ozs7O09BT0c7SUFDSCxLQUFLLENBQUMsS0FBSyxDQUFDLE1BQW9CO1FBQzVCLE1BQU0sSUFBSSxDQUFDLElBQUksQ0FBQyxpQkFBVSxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQztJQUNoRCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILElBQUksZUFBZSxLQUFLLE9BQU8sSUFBSSxDQUFDLGVBQWUsQ0FBQyxpQkFBVSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUV0RTs7Ozs7Ozs7T0FRRztJQUNILEtBQUssQ0FBQyxRQUFRLENBQUMsTUFBb0I7UUFDL0IsTUFBTSxRQUFRLEdBQUcsTUFBTSxJQUFJLENBQUMsSUFBSSxDQUFDLGlCQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQ3pELE9BQU8sUUFBUSxDQUFDLElBQUksRUFBRSxDQUFDO0lBQzNCLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsSUFBSSxhQUFhLEtBQUssT0FBTyxJQUFJLENBQUMsZUFBZSxDQUFDLGlCQUFVLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBRXBFOzs7Ozs7OztPQVFHO0lBQ0gsS0FBSyxDQUFDLFVBQVUsQ0FBQyxJQUFVLEVBQUUsTUFBb0I7UUFDN0MsTUFBTSxJQUFJLENBQUMsSUFBSSxDQUFDLGlCQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sRUFBRSxFQUFFLENBQUMsaUJBQVUsQ0FBQyxXQUFXLENBQUMsRUFBRSxJQUFJLENBQUMsSUFBSSxFQUFFLEVBQUUsSUFBSSxDQUFDLENBQUM7SUFDM0YsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxJQUFJLGFBQWEsS0FBSyxPQUFPLElBQUksQ0FBQyxlQUFlLENBQUMsaUJBQVUsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFFdkU7Ozs7Ozs7O09BUUc7SUFDSCxLQUFLLENBQUMsTUFBTSxDQUFDLE1BQW9CO1FBQzdCLE1BQU0sSUFBSSxDQUFDLElBQUksQ0FBQyxpQkFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLENBQUMsQ0FBQztJQUMvQyxDQUFDO0NBQ0o7QUFsRkQsb0NBa0ZDIn0=

package/endpoints/raw/UploadEndpoint.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.UploadEndpoint = void 0;
 const Endpoint_1 = require("../Endpoint");
@@ -25,7 +16,6 @@ class UploadEndpoint extends Endpoint_1.Endpoint {
     constructor(referrer, relativeUri, formField) {
         super(referrer, relativeUri);
         this.formField = formField;
-        this.formField = formField;
     }
     /**
      * Uploads data to the endpoint.
@@ -37,19 +27,17 @@ class UploadEndpoint extends Endpoint_1.Endpoint {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    uploadFrom(blob, signal) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const fileName = blob instanceof File ? blob.name : undefined;
-            if (this.formField) {
-                const formData = new FormData();
-                formData.set(this.formField, blob, fileName);
-                yield this.send(http_1.HttpMethod.Post, signal, { [http_1.HttpHeader.ContentType]: "multipart/form-data" }, formData);
-            }
-            else {
-                yield this.send(http_1.HttpMethod.Post, signal, { [http_1.HttpHeader.ContentType]: blob.type }, blob);
-            }
-        });
+    async uploadFrom(blob, signal) {
+        const fileName = blob instanceof File ? blob.name : undefined;
+        if (this.formField) {
+            const formData = new FormData();
+            formData.set(this.formField, blob, fileName);
+            await this.send(http_1.HttpMethod.Post, signal, undefined, formData);
+        }
+        else {
+            await this.send(http_1.HttpMethod.Post, signal, { [http_1.HttpHeader.ContentType]: blob.type }, blob);
+        }
     }
 }
 exports.UploadEndpoint = UploadEndpoint;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVXBsb2FkRW5kcG9pbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJVcGxvYWRFbmRwb2ludC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7QUFBQSwwQ0FBdUM7QUFDdkMscUNBQW9EO0FBRXBEOztHQUVHO0FBQ0gsTUFBYSxjQUFlLFNBQVEsbUJBQVE7SUFDeEM7Ozs7O09BS0c7SUFDSCxZQUFZLFFBQWtCLEVBQUUsV0FBeUIsRUFBbUIsU0FBa0I7UUFDMUYsS0FBSyxDQUFDLFFBQVEsRUFBRSxXQUFXLENBQUMsQ0FBQztRQUQyQyxjQUFTLEdBQVQsU0FBUyxDQUFTO1FBRTFGLElBQUksQ0FBQyxTQUFTLEdBQUcsU0FBUyxDQUFDO0lBQy9CLENBQUM7SUFFRDs7Ozs7Ozs7O09BU0c7SUFDRyxVQUFVLENBQUMsSUFBaUIsRUFBRSxNQUFvQjs7WUFDcEQsTUFBTSxRQUFRLEdBQUcsSUFBSSxZQUFZLElBQUksQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO1lBRTlELElBQUksSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO2dCQUNqQixNQUFNLFFBQVEsR0FBRyxJQUFJLFFBQVEsRUFBRSxDQUFDO2dCQUNoQyxRQUFRLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsSUFBSSxFQUFFLFFBQVEsQ0FBQyxDQUFDO2dCQUM3QyxNQUFNLElBQUksQ0FBQyxJQUFJLENBQUMsaUJBQVUsQ0FBQyxJQUFJLEVBQUUsTUFBTSxFQUFFLEVBQUUsQ0FBQyxpQkFBVSxDQUFDLFdBQVcsQ0FBQyxFQUFFLHFCQUFxQixFQUFFLEVBQUUsUUFBUSxDQUFDLENBQUM7WUFDNUcsQ0FBQztpQkFBTSxDQUFDO2dCQUNKLE1BQU0sSUFBSSxDQUFDLElBQUksQ0FBQyxpQkFBVSxDQUFDLElBQUksRUFBRSxNQUFNLEVBQUUsRUFBRSxDQUFDLGlCQUFVLENBQUMsV0FBVyxDQUFDLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRSxFQUFFLElBQUksQ0FBQyxDQUFDO1lBQzVGLENBQUM7UUFDTCxDQUFDO0tBQUE7Q0FDSjtBQWpDRCx3Q0FpQ0MifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVXBsb2FkRW5kcG9pbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJVcGxvYWRFbmRwb2ludC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSwwQ0FBdUM7QUFDdkMscUNBQW9EO0FBRXBEOztHQUVHO0FBQ0gsTUFBYSxjQUFlLFNBQVEsbUJBQVE7SUFDeEM7Ozs7O09BS0c7SUFDSCxZQUFZLFFBQWtCLEVBQUUsV0FBeUIsRUFBbUIsU0FBa0I7UUFDMUYsS0FBSyxDQUFDLFFBQVEsRUFBRSxXQUFXLENBQUMsQ0FBQztRQUQyQyxjQUFTLEdBQVQsU0FBUyxDQUFTO0lBRTlGLENBQUM7SUFFRDs7Ozs7Ozs7O09BU0c7SUFDSCxLQUFLLENBQUMsVUFBVSxDQUFDLElBQWlCLEVBQUUsTUFBb0I7UUFDcEQsTUFBTSxRQUFRLEdBQUcsSUFBSSxZQUFZLElBQUksQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO1FBRTlELElBQUksSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ2pCLE1BQU0sUUFBUSxHQUFHLElBQUksUUFBUSxFQUFFLENBQUM7WUFDaEMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLElBQUksRUFBRSxRQUFRLENBQUMsQ0FBQztZQUM3QyxNQUFNLElBQUksQ0FBQyxJQUFJLENBQUMsaUJBQVUsQ0FBQyxJQUFJLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxRQUFRLENBQUMsQ0FBQztRQUNsRSxDQUFDO2FBQU0sQ0FBQztZQUNKLE1BQU0sSUFBSSxDQUFDLElBQUksQ0FBQyxpQkFBVSxDQUFDLElBQUksRUFBRSxNQUFNLEVBQUUsRUFBRSxDQUFDLGlCQUFVLENBQUMsV0FBVyxDQUFDLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRSxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQzVGLENBQUM7SUFDTCxDQUFDO0NBQ0o7QUFoQ0Qsd0NBZ0NDIn0=

package/endpoints/raw/UploadEndpoint.test.ts

@@ -32,10 +32,7 @@ test('uploadFromForm', async () => {
 
     fetchMock.mockOnceIf(
         req => req.method === HttpMethod.Post && req.url === 'http://localhost/endpoint',
-        async req => {
-            expect(req.headers.get(HttpHeader.ContentType)).toBe('multipart/form-data');
-            return {};
-        }
+        async () => ({})
     );
 
     await endpoint.uploadFrom(file);

package/endpoints/raw/UploadEndpoint.ts

@@ -13,7 +13,6 @@ export class UploadEndpoint extends Endpoint {
      */
     constructor(referrer: Endpoint, relativeUri: URL | string, private readonly formField?: string) {
         super(referrer, relativeUri);
-        this.formField = formField;
     }
 
     /**
@@ -32,7 +31,7 @@ export class UploadEndpoint extends Endpoint {
         if (this.formField) {
             const formData = new FormData();
             formData.set(this.formField, blob, fileName);
-            await this.send(HttpMethod.Post, signal, { [HttpHeader.ContentType]: "multipart/form-data" }, formData);
+            await this.send(HttpMethod.Post, signal, undefined, formData);
         } else {
             await this.send(HttpMethod.Post, signal, { [HttpHeader.ContentType]: blob.type }, blob);
         }