shelving 1.166.0 → 1.167.0

package/api/Endpoint.d.ts

@@ -48,11 +48,27 @@ export declare class Endpoint<P, R> {
      */
     renderURL(payload: P, caller?: AnyCaller): string;
     /**
-     * Validate a payload against this endpoints payload schema, and return an HTTP `Request` that will send it to this endpoint.
+     * Get an HTTP `Request` object for this endpoint.
+     * - Validates a payload against this endpoints payload schema
+     * - Return an HTTP `Request` that will send it the valid payload to this endpoint.
+     *
+     * @throws Feedback if the payload is invalid.
      */
     request(payload: P, options?: EndpointOptions, caller?: AnyCaller): Request;
     /**
-     * Perform a fetch to this endpoint, and validate the returned response against this endpoint's result schema.
+     * Validate an HTTP `Response` against this endpoint.
+     * @throws ResponseError if the response status is not ok (200-299)
+     * @throws ResponseError if the response content is invalid.
+     */
+    response(response: Response, caller?: AnyCaller): Promise<R>;
+    /**
+     * Perform a fetch to this endpoint.
+     * - Validate the `payload` against this endpoint's payload schema.
+     * - Validate the returned response against this endpoint's result schema.
+     *
+     * @throws Feedback if the payload is invalid.
+     * @throws ResponseError if the response status is not ok (200-299)
+     * @throws ResponseError if the response content is invalid.
      */
     fetch(payload: P, options?: EndpointOptions, caller?: AnyCaller): Promise<R>;
     /** Convert to string, e.g. `GET https://a.com/user/{id}` */

package/api/Endpoint.js

@@ -70,18 +70,21 @@ export class Endpoint {
         return url;
     }
     /**
-     * Validate a payload against this endpoints payload schema, and return an HTTP `Request` that will send it to this endpoint.
+     * Get an HTTP `Request` object for this endpoint.
+     * - Validates a payload against this endpoints payload schema
+     * - Return an HTTP `Request` that will send it the valid payload to this endpoint.
+     *
+     * @throws Feedback if the payload is invalid.
      */
     request(payload, options = {}, caller = this.request) {
         return createRequest(this.method, this.url, this.payload.validate(payload), options, caller);
     }
     /**
-     * Perform a fetch to this endpoint, and validate the returned response against this endpoint's result schema.
+     * Validate an HTTP `Response` against this endpoint.
+     * @throws ResponseError if the response status is not ok (200-299)
+     * @throws ResponseError if the response content is invalid.
      */
-    async fetch(payload, options = {}, caller = this.fetch) {
-        // Fetch the response.
-        const request = this.request(payload, options, caller);
-        const response = await fetch(request);
+    async response(response, caller = this.response) {
         // Get the response.
         const { ok, status } = response;
         const content = await getResponseContent(response, caller);
@@ -91,6 +94,19 @@ export class Endpoint {
         // Validate the success response.
         return getValid(content, this.result, ResponseError, caller);
     }
+    /**
+     * Perform a fetch to this endpoint.
+     * - Validate the `payload` against this endpoint's payload schema.
+     * - Validate the returned response against this endpoint's result schema.
+     *
+     * @throws Feedback if the payload is invalid.
+     * @throws ResponseError if the response status is not ok (200-299)
+     * @throws ResponseError if the response content is invalid.
+     */
+    async fetch(payload, options = {}, caller = this.fetch) {
+        const response = await fetch(this.request(payload, options, caller));
+        return this.response(response, caller);
+    }
     /** Convert to string, e.g. `GET https://a.com/user/{id}` */
     toString() {
         return `${this.method} ${this.url}`;

package/package.json

@@ -11,7 +11,7 @@
 		"state-management",
 		"query-builder"
 	],
-	"version": "1.166.0",
+	"version": "1.167.0",
 	"repository": "https://github.com/dhoulb/shelving",
 	"author": "Dave Houlbrooke <dave@shax.com>",
 	"license": "0BSD",