typedrest 0.5.0 → 0.6.0

package/README.md

@@ -1,9 +1,42 @@
 # ![TypedRest](https://raw.githubusercontent.com/TypedRest/TypedRest-TypeScript/master/logo.svg) for TypeScript
 
-[![TypedRest](https://img.shields.io/npm/v/typedrest.svg)](https://www.npmjs.com/package/typedrest)
+[![Build](https://github.com/TypedRest/TypedRest-TypeScript/actions/workflows/build.yml/badge.svg)](https://github.com/TypedRest/TypedRest-TypeScript/actions/workflows/build.yml)
 [![API documentation](https://img.shields.io/badge/api-docs-orange.svg)](https://typescript.typedrest.net/)
-[![Build](https://github.com/TypedRest/TypedRest-TypeScript/actions/workflows/build.yml/badge.svg)](https://github.com/TypedRest/TypedRest-TypeScript/actions/workflows/build.yml)  
-TypedRest helps you build type-safe, fluent-style REST API clients. Common REST patterns such as collections are represented as classes, allowing you to write more idiomatic code.
+[![TypedRest](https://img.shields.io/npm/v/typedrest.svg)](https://www.npmjs.com/package/typedrest)
+
+**Describe your REST API as a tree of endpoints, not a list of HTTP calls.**
+
+TypedRest helps you build type-safe, fluent-style REST API clients. Common REST patterns are represented as classes that you compose to mirror the URL structure of your API.
+
+Tell TypedRest that `/contacts` is a collection and get type-safe listing, creating, reading, updating and deleting in return. Unlike typical generated clients, which give you one flat method per operation, TypedRest gives you a navigable tree of endpoints.
+
+## Define your client
+
+A few lines are enough to describe an API with a collection of contacts plus a "notes" endpoint nested underneath:
+
+```typescript
+class MyClient extends EntryEndpoint {
+  get contacts() {
+    return new ContactCollectionEndpoint(this);
+  }
+}
+
+class ContactCollectionEndpoint extends GenericCollectionEndpoint<Contact, ContactEndpoint> {
+  constructor(referrer: Endpoint) {
+    super(referrer, "./contacts", ContactEndpoint);
+  }
+}
+
+class ContactEndpoint extends ElementEndpoint<Contact> {
+  get note() {
+    return new ElementEndpoint<Note>(this, "./note");
+  }
+}
+```
+
+## Use it
+
+Navigate the API like an object model, with code completion guiding the way:
 
 ```typescript
 const client = new MyClient(new URL("http://example.com/"));
@@ -28,6 +61,9 @@ const note: Note = await smith.note.read();
 await smith.delete();
 ```
 
-Read a more detailed **[Introduction](https://typedrest.net/introduction/)** to TypedRest or jump right in with the **[setup guide](https://typedrest.net/setup/typescript/)**.
+## Learn more
+
+Read a more detailed **[Introduction](https://typedrest.net/introduction/)** to TypedRest or jump right in with the **[setup guide](https://typedrest.net/setup/typescript/)**.  
+You can also **[build your first client](https://typedrest.net/tutorials/first-client/)** step by step or **[generate one from OpenAPI](https://typedrest.net/tutorials/from-openapi/)**.
 
-You can also take a look at our [Sample project](https://github.com/TypedRest/Sample-TypeScript).
+Take a look at our [Sample project](https://github.com/TypedRest/Sample-TypeScript) to see TypedRest in action.

package/endpoints/{CachingEndpoint.ts → CachingEndpoint.d.ts}

@@ -1,5 +1,4 @@
 import { ResponseCache } from "../http";
-
 /**
  * Endpoint that caches the last response.
  */

package/endpoints/Endpoint.d.ts

@@ -0,0 +1,121 @@
+import { HttpMethod, HttpClient } from "../http";
+import { Serializer } from "../serializers";
+import { ErrorHandler } from "../errors";
+import { LinkExtractor } from "../links";
+export declare class Endpoint {
+    /**
+     * The HTTP URI of the remote resource.
+     */
+    readonly uri: URL;
+    /**
+     * The HTTP client used to communicate with the remote resource.
+     */
+    readonly httpClient: HttpClient;
+    /**
+     * Controls the serialization of entities sent to and received from the server.
+     */
+    readonly serializer: Serializer;
+    /**
+     * Handles errors in responses.
+     */
+    readonly errorHandler: ErrorHandler;
+    /**
+     * Extracts links from responses.
+     */
+    readonly linkExtractor: LinkExtractor;
+    /**
+     * Creates a new endpoint.
+     * @param referrer The endpoint used to navigate to this one. Must be defined except for top-level endpoint.
+     * @param uri The HTTP URI of the remote element. May be relative if `referrer` is defined.
+     * @param serializer Controls the serialization of entities sent to and received from the server. Taken from `referrer` instead if it is defined.
+     * @param errorHandler Handles errors in responses. Taken from `referrer` instead if it is defined.
+     * @param linkExtractor Extracts links from responses. Taken from `referrer` instead if it is defined.
+     * @param httpClient The HTTP client used to communicate with the remote resource. Taken from `referrer` instead if it is defined.
+     */
+    constructor(referrer: Endpoint | undefined, uri: URL | string, serializer?: Serializer, errorHandler?: ErrorHandler, linkExtractor?: LinkExtractor, httpClient?: HttpClient);
+    /**
+     * Resolves a relative URI using this endpoint's URI as the base.
+     * @param relativeUri The relative URI to resolve. Prepend `./` to imply a trailing slash in the base URI even if it is missing there.
+     */
+    protected join(relativeUri: string): URL;
+    /**
+     * Adds a trailing slash to the URI if it does not already have one.
+     */
+    protected static ensureTrailingSlash(uri: URL | string): URL;
+    /**
+     * Sends an HTTP request to this endpoint's URI.
+     * Handles various cross-cutting concerns regarding a response message such as discovering links and handling errors.
+     * @param method The HTTP method to use.
+     * @param signal Used to cancel the request.
+     * @param headers The HTTP headers to set.
+     * @param body The body to send.
+     * @throws {@link errors!HttpError}
+     */
+    protected send(method: HttpMethod, signal?: AbortSignal, headers?: RequestInit["headers"], body?: RequestInit["body"]): Promise<Response>;
+    /**
+     * Handles various cross-cutting concerns regarding a response message such as discovering links and handling errors.
+     * @param response The response to process.
+     * @throws {@link errors!HttpError}
+     */
+    protected handle(response: Response): Promise<void>;
+    private links;
+    private defaultLinks;
+    private defaultLinkTemplates;
+    /**
+     * Registers one or more default links for a specific relation type.
+     * These links are used when no links with this relation type are provided by the server.
+     * This should only be called during initial setup of the endpoint.
+     * @param rel The relation type of the link to add.
+     * @param href The href of the link relative to this endpoint's URI. Leave unspecified to remove any previous entries for the relation type.
+     */
+    setDefaultLink(rel: string, href?: string): void;
+    /**
+     * Registers a default link template for a specific relation type.
+     * This template is used when no template with this relation type is provided by the server.
+     * This should only be called during initial setup of the endpoint.
+     * @param rel The relation type of the link to add.
+     * @param href The templates href relative to this endpoint's URI. Leave unspecified to remove any previous entries for the relation type.
+     */
+    setDefaultLinkTemplate(rel: string, href?: string): void;
+    /**
+     * Resolves all links with a specific relation type. Uses cached data from last response.
+     * @param rel The relation type of the links to look for.
+     */
+    getLinks(rel: string): {
+        uri: URL;
+        title?: string;
+    }[];
+    /**
+     * Resolves a single link with a specific relation type. Uses cached data from last response.
+     * @param rel The relation type of the link to look for.
+     * @throws {@link errors!NotFoundError}: No link with the specified `rel` could be found.
+     */
+    link(rel: string): URL;
+    /**
+     * Resolves a link template with a specific relation type. Uses cached data from last response.
+     * @param rel The relation type of the link template to look for.
+     * @param variables Variables for resolving the template.
+     * @throws {@link errors!NotFoundError}: No link template with the specified `rel` could be found.
+     */
+    linkTemplate(rel: string, variables: {
+        [key: string]: any;
+    }): URL;
+    /**
+     * Retrieves a link template with a specific relation type. Uses cached data from last response. Prefer {@link linkTemplate} when possible.
+     * @param rel The relation type of the link template to look for.
+     * @throws {@link errors!NotFoundError}: No link template with the specified `rel` could be found.
+     */
+    getLinkTemplate(rel: string): string;
+    private allowedMethods;
+    /**
+     * Handles allowed HTTP methods and other capabilities reported by the server.
+     */
+    protected handleCapabilities(response: Response): void;
+    /**
+     * Shows whether the server has indicated that a specific HTTP method is currently allowed.
+     * Uses cached data from last response.
+     * @param method The HTTP methods (e.g. GET, POST, ...) to check.
+     * @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 allowed methods.
+     */
+    protected isMethodAllowed(method: HttpMethod): boolean | undefined;
+}

package/endpoints/Endpoint.js

@@ -197,4 +197,4 @@ class Endpoint {
     }
 }
 exports.Endpoint = Endpoint;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRW5kcG9pbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJFbmRwb2ludC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSxrQ0FBNkU7QUFFN0Usc0NBQXdEO0FBRXhELGdFQUFvQztBQUVwQyxNQUFhLFFBQVE7SUEwQmpCOzs7Ozs7OztPQVFHO0lBQ0gsWUFDSSxRQUE4QixFQUM5QixHQUFpQixFQUNqQixVQUF1QixFQUN2QixZQUEyQixFQUMzQixhQUE2QixFQUM3QixVQUF1QjtRQThFM0Isb0ZBQW9GO1FBQzVFLFVBQUssR0FBVyxFQUFFLENBQUM7UUFFM0IsNERBQTREO1FBQ3BELGlCQUFZLEdBQUcsSUFBSSxHQUFHLEVBQWUsQ0FBQztRQUN0Qyx5QkFBb0IsR0FBRyxJQUFJLEdBQUcsRUFBa0IsQ0FBQztRQTJGekQsb0ZBQW9GO1FBQzVFLG1CQUFjLEdBQWlCLEVBQUUsQ0FBQztRQTlLdEMsSUFBSSxRQUFRLEVBQUUsQ0FBQztZQUNYLElBQUksQ0FBQyxHQUFHLEdBQUcsQ0FBQyxPQUFPLEdBQUcsS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDO1lBQ2hFLElBQUksVUFBVTtnQkFDVixNQUFNLElBQUksS0FBSyxDQUFDLDREQUE0RCxDQUFDLENBQUM7WUFDbEYsSUFBSSxDQUFDLFVBQVUsR0FBRyxRQUFRLENBQUMsVUFBVSxDQUFDO1lBQ3RDLElBQUksWUFBWTtnQkFDWixNQUFNLElBQUksS0FBSyxDQUFDLDhEQUE4RCxDQUFDLENBQUM7WUFDcEYsSUFBSSxDQUFDLFlBQVksR0FBRyxRQUFRLENBQUMsWUFBWSxDQUFDO1lBQzFDLElBQUksYUFBYTtnQkFDYixNQUFNLElBQUksS0FBSyxDQUFDLCtEQUErRCxDQUFDLENBQUM7WUFDckYsSUFBSSxDQUFDLGFBQWEsR0FBRyxRQUFRLENBQUMsYUFBYSxDQUFDO1lBQzVDLElB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRW5kcG9pbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJFbmRwb2ludC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSxrQ0FBNkU7QUFFN0Usc0NBQXdEO0FBRXhELGdFQUFvQztBQUVwQyxNQUFhLFFBQVE7SUEwQmpCOzs7Ozs7OztPQVFHO0lBQ0gsWUFDSSxRQUE4QixFQUM5QixHQUFpQixFQUNqQixVQUF1QixFQUN2QixZQUEyQixFQUMzQixhQUE2QixFQUM3QixVQUF1QjtRQThFM0Isb0ZBQW9GO1FBQzVFLFVBQUssR0FBVyxFQUFFLENBQUM7UUFFM0IsNERBQTREO1FBQ3BELGlCQUFZLEdBQUcsSUFBSSxHQUFHLEVBQWUsQ0FBQztRQUN0Qyx5QkFBb0IsR0FBRyxJQUFJLEdBQUcsRUFBa0IsQ0FBQztRQTJGekQsb0ZBQW9GO1FBQzVFLG1CQUFjLEdBQWlCLEVBQUUsQ0FBQztRQTlLdEMsSUFBSSxRQUFRLEVBQUUsQ0FBQztZQUNYLElBQUksQ0FBQyxHQUFHLEdBQUcsQ0FBQyxPQUFPLEdBQUcsS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDO1lBQ2hFLElBQUksVUFBVTtnQkFDVixNQUFNLElBQUksS0FBSyxDQUFDLDREQUE0RCxDQUFDLENBQUM7WUFDbEYsSUFBSSxDQUFDLFVBQVUsR0FBRyxRQUFRLENBQUMsVUFBVSxDQUFDO1lBQ3RDLElBQUksWUFBWTtnQkFDWixNQUFNLElBQUksS0FBSyxDQUFDLDhEQUE4RCxDQUFDLENBQUM7WUFDcEYsSUFBSSxDQUFDLFlBQVksR0FBRyxRQUFRLENBQUMsWUFBWSxDQUFDO1lBQzFDLElBQUksYUFBYTtnQkFDYixNQUFNLElBQUksS0FBSyxDQUFDLCtEQUErRCxDQUFDLENBQUM7WUFDckYsSUFBSSxDQUFDLGFBQWEsR0FBRyxRQUFRLENBQUMsYUFBYSxDQUFDO1lBQzVDLElBQUksVUFBVTtnQkFDVixNQUFNLElBQUksS0FBSyxDQUFDLDREQUE0RCxDQUFDLENBQUM7WUFDbEYsSUFBSSxDQUFDLFVBQVUsR0FBRyxRQUFRLENBQUMsVUFBVSxDQUFDO1FBQzFDLENBQUM7YUFBTSxDQUFDO1lBQ0osSUFBSSxDQUFDLEdBQUcsR0FBRyxDQUFDLE9BQU8sR0FBRyxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDO1lBQzFELElBQUksQ0FBQyxVQUFVO2dCQUNYLE1BQU0sSUFBSSxLQUFLLENBQUMsNERBQTRELENBQUMsQ0FBQztZQUNsRixJQUFJLENBQUMsVUFBVSxHQUFHLFVBQVUsQ0FBQztZQUM3QixJQUFJLENBQUMsWUFBWTtnQkFDYixNQUFNLElBQUksS0FBSyxDQUFDLDhEQUE4RCxDQUFDLENBQUM7WUFDcEYsSUFBSSxDQUFDLFlBQVksR0FBRyxZQUFZLENBQUM7WUFDakMsSUFBSSxDQUFDLGFBQWE7Z0JBQ2QsTUFBTSxJQUFJLEtBQUssQ0FBQywrREFBK0QsQ0FBQyxDQUFDO1lBQ3JGLElBQUksQ0FBQyxhQUFhLEdBQUcsYUFBYSxDQUFDO1lBQ25DLElBQUksQ0FBQyxVQUFVO2dCQUNYLE1BQU0sSUFBSSxLQUFLLENBQUMsNERBQTRELENBQUMsQ0FBQztZQUNsRixJQUFJLENBQUMsVUFBVSxHQUFHLFVBQVUsQ0FBQztRQUNqQyxDQUFDO0lBQ0wsQ0FBQztJQUVEOzs7T0FHRztJQUNPLElBQUksQ0FBQyxXQUFtQjtRQUM5QixPQUFPLElBQUksR0FBRyxDQUNWLFdBQVcsRUFDWCxXQUFXLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsbUJBQW1CLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDMUYsQ0FBQztJQUVEOztPQUVHO0lBQ08sTUFBTSxDQUFDLG1CQUFtQixDQUFDLEdBQWlCO1FBQ2xELElBQUksU0FBUyxHQUFHLENBQUMsT0FBTyxHQUFHLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQztRQUMzRCxJQUFJLENBQUMsU0FBUyxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUM7WUFDeEIsU0FBUyxJQUFJLEdBQUcsQ0FBQztRQUNyQixPQUFPLElBQUksR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzlCLENBQUM7SUFFRDs7Ozs7Ozs7T0FRRztJQUNPLEtBQUssQ0FBQyxJQUFJLENBQUMsTUFBa0IsRUFBRSxNQUFvQixFQUFFLE9BQWdDLEVBQUUsSUFBMEI7UUFDdkgsTUFBTSxRQUFRLEdBQUcsTUFBTSxJQUFJLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsT0FBTyxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQ3JGLE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztRQUM1QixPQUFPLFFBQVEsQ0FBQztJQUNwQixDQUFDO0lBRUQ7Ozs7T0FJRztJQUNPLEtBQUssQ0FBQyxNQUFNLENBQUMsUUFBa0I7UUFDckMsSUFBSSxDQUFDLEtBQUssR0FBRyxNQUFNLElBQUksQ0FBQyxhQUFhLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxDQUFDO1FBQ3pELElBQUksQ0FBQyxrQkFBa0IsQ0FBQyxRQUFRLENBQUMsQ0FBQztRQUNsQyxNQUFNLElBQUksQ0FBQyxZQUFZLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQzdDLENBQUM7SUFTRDs7Ozs7O09BTUc7SUFDSCxjQUFjLENBQUMsR0FBVyxFQUFFLElBQWE7UUFDckMsSUFBSSxJQUFJLEVBQUUsQ0FBQztZQUNQLElBQUksQ0FBQyxZQUFZLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUM7UUFDaEQsQ0FBQzthQUFNLENBQUM7WUFDSixJQUFJLENBQUMsWUFBWSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUNsQyxDQUFDO0lBQ0wsQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNILHNCQUFzQixDQUFDLEdBQVcsRUFBRSxJQUFhO1FBQzdDLElBQUksSUFBSSxFQUFFLENBQUM7WUFDUCxJQUFJLENBQUMsb0JBQW9CLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxJQUFJLENBQUMsQ0FBQztRQUM3QyxDQUFDO2FBQU0sQ0FBQztZQUNKLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDMUMsQ0FBQztJQUNMLENBQUM7SUFFRDs7O09BR0c7SUFDSCxRQUFRLENBQUMsR0FBVztRQUNoQixNQUFNLEtBQUssR0FBb0MsSUFBSSxDQUFDLEtBQUs7YUFDcEQsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsU0FBUyxJQUFJLENBQUMsQ0FBQyxHQUFHLEtBQUssR0FBRyxDQUFDO2FBQzFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRTtZQUNMLE9BQU8sRUFBRSxHQUFHLEVBQUUsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLEVBQUUsS0FBSyxFQUFFLENBQUMsQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUN0RCxDQUFDLENBQUMsQ0FBQztRQUVQLE1BQU0sV0FBVyxHQUFHLElBQUksQ0FBQyxZQUFZLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQy9DLElBQUksS0FBSyxDQUFDLE1BQU0sS0FBSyxDQUFDLElBQUksV0FBVyxFQUFFLENBQUM7WUFDcEMsS0FBSyxDQUFDLElBQUksQ0FBQyxFQUFFLEdBQUcsRUFBRSxXQUFXLEVBQUUsQ0FBQyxDQUFDO1FBQ3JDLENBQUM7UUFFRCxPQUFPLEtBQUssQ0FBQztJQUNqQixDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILElBQUksQ0FBQyxHQUFXO1FBQ1osTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUVqQyxJQUFJLEtBQUssQ0FBQyxNQUFNLEtBQUssQ0FBQztZQUNsQixNQUFNLElBQUksc0JBQWEsQ0FBQyxvQkFBb0IsR0FBRyx5QkFBeUIsSUFBSSxDQUFDLEdBQUcsR0FBRyxFQUFFLHFCQUFjLENBQUMsUUFBUSxDQUFDLENBQUM7UUFFbEgsT0FBTyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDO0lBQ3hCLENBQUM7SUFFRDs7Ozs7T0FLRztJQUNILFlBQVksQ0FBQyxHQUFXLEVBQUUsU0FBa0M7UUFDeEQsTUFBTSxJQUFJLEdBQUcsc0JBQVEsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLGVBQWUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFBO1FBQ3RELE9BQU8sSUFBSSxHQUFHLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQTtJQUNyRCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILGVBQWUsQ0FBQyxHQUFXOztRQUN2QixNQUFNLFFBQVEsR0FBRyxNQUFBLE1BQUEsSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsU0FBUyxJQUFJLENBQUMsQ0FBQyxHQUFHLEtBQUssR0FBRyxDQUFDLDBDQUFFLElBQUksbUNBQ2xFLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUM7UUFFMUMsSUFBSSxDQUFDLFFBQVE7WUFDVCxNQUFNLElBQUksc0JBQWEsQ0FBQyw2QkFBNkIsR0FBRyx5QkFBeUIsSUFBSSxDQUFDLEdBQUcsR0FBRyxFQUFFLHFCQUFjLENBQUMsUUFBUSxDQUFDLENBQUM7UUFFM0gsT0FBTyxRQUFRLENBQUM7SUFDcEIsQ0FBQztJQUtEOztPQUVHO0lBQ08sa0JBQWtCLENBQUMsUUFBa0I7UUFDM0MsTUFBTSxNQUFNLEdBQUcsUUFBUSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsaUJBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUN0RCxJQUFJLE1BQU0sRUFBRSxDQUFDO1lBQ1QsSUFBSSxDQUFDLGNBQWMsR0FBRyxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBaUIsQ0FBQztRQUM3RCxDQUFDO0lBQ0wsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ08sZUFBZSxDQUFDLE1BQWtCO1FBQ3hDLElBQUksSUFBSSxDQUFDLGNBQWMsQ0FBQyxNQUFNLEtBQUssQ0FBQztZQUNoQyxPQUFPLFNBQVMsQ0FBQztRQUVyQixPQUFPLElBQUksQ0FBQyxjQUFjLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO0lBQ3RELENBQUM7Q0FDSjtBQWhQRCw0QkFnUEMifQ==

package/endpoints/{EntryEndpoint.ts → EntryEndpoint.d.ts}

@@ -1,13 +1,12 @@
 import { Endpoint } from "./Endpoint";
-import { HttpMethod, HttpClient, FetchHttpClient, HttpHeader } from "../http";
-import { Serializer, JsonSerializer } from "../serializers";
-import { ErrorHandler, DefaultErrorHandler } from "../errors";
-import { LinkExtractor, AggregateLinkExtractor, HeaderLinkExtractor, HalLinkExtractor } from "../links";
-
+import { HttpClient } from "../http";
+import { Serializer } from "../serializers";
+import { ErrorHandler } from "../errors";
+import { LinkExtractor } from "../links";
 /**
  * Represent the top-level URI of an API. Derive from this class and add your own set of child-{@link Endpoint}s as properties.
  */
-export class EntryEndpoint extends Endpoint {
+export declare class EntryEndpoint extends Endpoint {
     /**
      * Creates a new entry endpoint.
      * @param uri The base URI of the REST API.<br>Missing trailing slash will be appended automatically.
@@ -16,24 +15,7 @@ export class EntryEndpoint extends Endpoint {
      * @param linkExtractor Detects links in HTTP responses.<br>Defaults to {@link links!HeaderLinkExtractor} and {@link links!HalLinkExtractor} combined via {@link links!AggregateLinkExtractor} if undefined.
      * @param httpClient The HTTP client used to communicate with the REST API.<br>Defaults to {@link http!FetchHttpClient} if undefined.
      */
-    constructor(
-        uri: URL | string,
-        serializer?: Serializer,
-        errorHandler?: ErrorHandler,
-        linkExtractor?: LinkExtractor,
-        httpClient?: HttpClient) {
-        super(undefined,
-            Endpoint.ensureTrailingSlash(uri),
-            serializer ?? new JsonSerializer(),
-            errorHandler ?? new DefaultErrorHandler(),
-            linkExtractor ?? new AggregateLinkExtractor(new HeaderLinkExtractor(), new HalLinkExtractor()),
-            httpClient ?? new FetchHttpClient());
-
-        for (const mediaType of this.serializer.supportedMediaTypes) {
-            this.httpClient.defaultHeaders.append(HttpHeader.Accept, mediaType);
-        }
-    }
-
+    constructor(uri: URL | string, serializer?: Serializer, errorHandler?: ErrorHandler, linkExtractor?: LinkExtractor, httpClient?: HttpClient);
     /**
      * Fetches meta data such as links from the server.
      * @param signal Used to cancel the request.
@@ -42,7 +24,5 @@ export class EntryEndpoint extends Endpoint {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    async readMeta(signal?: AbortSignal) {
-        await this.send(HttpMethod.Get, signal);
-    }
+    readMeta(signal?: AbortSignal): Promise<void>;
 }

package/endpoints/generic/{CollectionEndpoint.ts → CollectionEndpoint.d.ts}

@@ -1,19 +1,16 @@
 import { GenericCollectionEndpoint } from "./GenericCollectionEndpoint";
 import { ElementEndpoint } from "./ElementEndpoint";
 import { Endpoint } from "../Endpoint";
-
 /**
  * Endpoint for a collection of `TEntity`s addressable as `ElementEndpoint<TEntity>`s.<br>
  * Use {@link GenericCollectionEndpoint} instead if you wish to customize the element endpoint type.
  * @typeParam TEntity The type of individual elements in the collection.
  */
-export class CollectionEndpoint<TEntity> extends GenericCollectionEndpoint<TEntity, ElementEndpoint<TEntity>> {
+export declare class CollectionEndpoint<TEntity> extends GenericCollectionEndpoint<TEntity, ElementEndpoint<TEntity>> {
     /**
      * Creates a new collection endpoint.
      * @param referrer The endpoint used to navigate to this one.
      * @param relativeUri The URI of this endpoint relative to the `referrer`'s. Add a `./` prefix here to imply a trailing slash in the `referrer`'s URI.
      */
-    constructor(referrer: Endpoint, relativeUri: URL | string) {
-        super(referrer, relativeUri, ElementEndpoint);
-    }
+    constructor(referrer: Endpoint, relativeUri: URL | string);
 }

package/endpoints/generic/{ETagEndpointBase.ts → ETagEndpointBase.d.ts}

@@ -1,25 +1,20 @@
 import { Endpoint } from "../Endpoint";
 import { CachingEndpoint } from "../CachingEndpoint";
-import { HttpMethod, HttpHeader, HttpStatusCode, ResponseCache } from "../../http";
-
+import { ResponseCache } from "../../http";
 /**
  * Base class for building endpoints that use ETags (entity tags) for caching and to avoid lost updates.
  */
-export class ETagEndpointBase extends Endpoint implements CachingEndpoint {
+export declare class ETagEndpointBase extends Endpoint implements CachingEndpoint {
     /**
      * Creates a new endpoint.
      * @param referrer The endpoint used to navigate to this one.
      * @param relativeUri The URI of this endpoint relative to the `referrer`'s. Add a `./` prefix here to imply a trailing slash in the `referrer`'s URI.
      */
-    constructor(referrer: Endpoint, relativeUri: URL | string) {
-        super(referrer, relativeUri);
-    }
-
+    constructor(referrer: Endpoint, relativeUri: URL | string);
     /**
      * @inheritDoc
      */
-    public responseCache?: ResponseCache;
-
+    responseCache?: ResponseCache;
     /**
      * Performs an {@link http!HttpMethod.Put} request on the {@link uri} and caches the response if the server sends an {@link http!HttpHeader.ETag}.
      * @param signal Used to cancel the request.
@@ -29,19 +24,7 @@ export class ETagEndpointBase extends Endpoint implements CachingEndpoint {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    protected async getContent(signal?: AbortSignal): Promise<string> {
-        const headers = new Headers();
-        if (this.responseCache?.eTag) headers.append(HttpHeader.IfNoneMatch, this.responseCache.eTag);
-
-        const response = await this.httpClient.send(this.uri, HttpMethod.Get, signal, new Headers(headers));
-        if (response.status !== HttpStatusCode.NotModified || !this.responseCache?.content) {
-            await this.handle(response);
-            this.responseCache = await ResponseCache.from(response);
-        }
-
-        return this.responseCache.content;
-    }
-
+    protected getContent(signal?: AbortSignal): Promise<string>;
     /**
      * Performs an {@link http!HttpMethod.Put} request on the {@link uri}. Sets {@link http!HttpHeader.IfMatch} if there is a cached {@link http!HttpHeader.ETag} to detect lost updates.
      * @param signal Used to cancel the request.
@@ -52,15 +35,7 @@ export class ETagEndpointBase extends Endpoint implements CachingEndpoint {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    protected async putContent(content: any, signal?: AbortSignal): Promise<Response> {
-        const headers = new Headers();
-        headers.append(HttpHeader.ContentType, this.serializer.supportedMediaTypes[0])
-        if (this.responseCache?.eTag) headers.append(HttpHeader.IfMatch, this.responseCache.eTag);
-
-        this.responseCache = undefined;
-        return this.send(HttpMethod.Put, signal, headers, this.serializer.serialize(content));
-    }
-
+    protected putContent(content: any, signal?: AbortSignal): Promise<Response>;
     /**
      * Performs an {@link http!HttpMethod.Delete} request on the {@link uri}. Sets {@link http!HttpHeader.IfMatch} if there is a cached {@link http!HttpHeader.ETag} to detect lost updates.
      * @param signal Used to cancel the request.
@@ -71,11 +46,5 @@ export class ETagEndpointBase extends Endpoint implements CachingEndpoint {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    protected async deleteContent(signal?: AbortSignal): Promise<Response> {
-        const headers = new Headers();
-        if (this.responseCache?.eTag) headers.append(HttpHeader.IfMatch, this.responseCache.eTag);
-
-        this.responseCache = undefined;
-        return this.send(HttpMethod.Delete, signal, headers);
-    }
+    protected deleteContent(signal?: AbortSignal): Promise<Response>;
 }

package/endpoints/generic/{ElementEndpoint.ts → ElementEndpoint.d.ts}

@@ -1,31 +1,20 @@
 import { ETagEndpointBase } from "./ETagEndpointBase";
 import { Endpoint } from "../Endpoint";
-import { HttpMethod, HttpHeader, HttpStatusCode } from "../../http";
-import { ConcurrencyError } from "../../errors";
-
 /**
  * Endpoint for an individual resource.
  * @typeParam TEntity The type of entity the endpoint represents.
  */
-export class ElementEndpoint<TEntity> extends ETagEndpointBase {
+export declare class ElementEndpoint<TEntity> extends ETagEndpointBase {
     /**
      * Creates a new element endpoint.
      * @param referrer The endpoint used to navigate to this one.
      * @param relativeUri The URI of this endpoint relative to the `referrer`'s. Add a `./` prefix here to imply a trailing slash in the `referrer`'s URI.
      */
-    constructor(referrer: Endpoint, relativeUri: URL | string) {
-        super(referrer, relativeUri);
-    }
-
+    constructor(referrer: Endpoint, relativeUri: URL | string);
     /**
      * A cached copy of the entity as received from the server.
      */
-    public get response(): TEntity | undefined {
-        return this.responseCache
-            ? this.serializer.deserialize<TEntity>(this.responseCache.content)
-            : undefined;
-    }
-
+    get response(): TEntity | undefined;
     /**
      * Returns the `TEntity`.
      * @param signal Used to cancel the request.
@@ -34,10 +23,7 @@ export class ElementEndpoint<TEntity> extends ETagEndpointBase {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    async read(signal?: AbortSignal) {
-        return this.serializer.deserialize<TEntity>(await this.getContent(signal));
-    }
-
+    read(signal?: AbortSignal): Promise<TEntity>;
     /**
      * Determines whether the element currently exists.
      * @param signal Used to cancel the request.
@@ -45,22 +31,13 @@ export class ElementEndpoint<TEntity> extends ETagEndpointBase {
      * @throws {@link errors!AuthorizationError}: {@link http!HttpStatusCode.Forbidden}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    async exists(signal?: AbortSignal) {
-        const response = await this.httpClient.send(this.uri, HttpMethod.Head, signal);
-        if (response.ok) return true;
-        if (response.status === HttpStatusCode.NotFound || response.status === HttpStatusCode.Gone) return false;
-
-        await this.errorHandler.handle(response);
-        return false;
-    }
-
+    exists(signal?: AbortSignal): Promise<boolean>;
     /**
      * Shows whether the server has indicated that {@link set} 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 allowed methods.
      */
-    get setAllowed() { return this.isMethodAllowed(HttpMethod.Put); }
-
+    get setAllowed(): boolean | undefined;
     /**
      * Sets/replaces the `TEntity`.
      * @param entity The new `TEntity`.
@@ -73,21 +50,13 @@ export class ElementEndpoint<TEntity> extends ETagEndpointBase {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    async set(entity: TEntity, signal?: AbortSignal): Promise<(TEntity | undefined)> {
-        const response = await this.putContent(entity, signal);
-        const text = await response.text();
-        if (text) {
-            return this.serializer.deserialize<TEntity>(text);
-        }
-    }
-
+    set(entity: TEntity, signal?: AbortSignal): Promise<(TEntity | undefined)>;
     /**
      * Shows whether the server has indicated that {@link merge} 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 allowed methods.
      */
-    get mergeAllowed() { return this.isMethodAllowed(HttpMethod.Patch); }
-
+    get mergeAllowed(): boolean | undefined;
     /**
      * Modifies an existing `TEntity` by merging changes on the server-side.
      * @param entity The `TEntity` data to merge with the existing element.
@@ -100,18 +69,7 @@ export class ElementEndpoint<TEntity> extends ETagEndpointBase {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    async merge(entity: TEntity, signal?: AbortSignal): Promise<(TEntity | undefined)> {
-        this.responseCache = undefined;
-        const response = await this.send(HttpMethod.Patch, signal, {
-            [HttpHeader.ContentType]: this.serializer.supportedMediaTypes[0]
-        }, this.serializer.serialize(entity));
-
-        const text = await response.text();
-        if (text) {
-            return this.serializer.deserialize<TEntity>(text);
-        }
-    }
-
+    merge(entity: TEntity, signal?: AbortSignal): Promise<(TEntity | undefined)>;
     /**
      * Reads the current state of the entity, applies a change to it and stores the result. Applies optimistic concurrency using automatic retries.
      * @param updateAction A callback that takes the current state of the entity and applies the desired modifications.
@@ -125,27 +83,13 @@ export class ElementEndpoint<TEntity> extends ETagEndpointBase {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    async update(updateAction: (entity: TEntity) => void, maxRetries: number = 3, signal?: AbortSignal): Promise<(TEntity | undefined)> {
-        let retryCounter = 0;
-        while (true) {
-            const entity = await this.read(signal);
-            updateAction(entity);
-            try {
-                return await this.set(entity, signal);
-            } catch (err) {
-                if (retryCounter++ >= maxRetries || !(err instanceof ConcurrencyError))
-                    throw err;
-            }
-        }
-    }
-
+    update(updateAction: (entity: TEntity) => void, maxRetries?: number, signal?: AbortSignal): Promise<(TEntity | undefined)>;
     /**
      * Shows whether the server has indicated that {@link delete} 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 allowed methods.
      */
-    get deleteAllowed() { return this.isMethodAllowed(HttpMethod.Delete); }
-
+    get deleteAllowed(): boolean | undefined;
     /**
      * Deletes the element.
      * @param signal Used to cancel the request.
@@ -155,7 +99,5 @@ export class ElementEndpoint<TEntity> extends ETagEndpointBase {
      * @throws {@link errors!NotFoundError}: {@link http!HttpStatusCode.NotFound} or {@link http!HttpStatusCode.Gone}
      * @throws {@link errors!HttpError}: Other non-success status code
      */
-    async delete(signal?: AbortSignal) {
-        await this.deleteContent(signal);
-    }
+    delete(signal?: AbortSignal): Promise<void>;
 }