ce-storefront 0.13.1 → 0.13.3

package/FUNCTIONS.md

@@ -21,7 +21,6 @@ specific category of applications.
 ```typescript
 import { CeStorefrontCore } from "ce-storefront/core.js";
 import { catalogListProducts } from "ce-storefront/funcs/catalogListProducts.js";
-import { SDKValidationError } from "ce-storefront/models/errors/sdkvalidationerror.js";
 
 // Use `CeStorefrontCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
@@ -33,28 +32,12 @@ async function run() {
   const res = await catalogListProducts(ceStorefront, {
     sortBy: "{\"country\":\"asc\",\"city\":\"asc\",\"population\":\"desc\"}",
   });
-
-  switch (true) {
-    case res.ok:
-      // The success case will be handled outside of the switch block
-      break;
-    case res.error instanceof SDKValidationError:
-      // Pretty-print validation errors.
-      return console.log(res.error.pretty());
-    case res.error instanceof Error:
-      return console.log(res.error);
-    default:
-      // TypeScript's type checking will fail on the following line if the above
-      // cases were not exhaustive.
-      res.error satisfies never;
-      throw new Error("Assertion failed: expected error checks to be exhaustive: " + res.error);
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("catalogListProducts failed:", res.error);
   }
-
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();

package/README.md

@@ -89,7 +89,6 @@ async function run() {
     sortBy: "{\"country\":\"asc\",\"city\":\"asc\",\"population\":\"desc\"}",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -275,7 +274,6 @@ async function run() {
     },
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -306,7 +304,6 @@ async function run() {
     sortBy: "{\"country\":\"asc\",\"city\":\"asc\",\"population\":\"desc\"}",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -318,61 +315,49 @@ run();
 <!-- Start Error Handling [errors] -->
 ## Error Handling
 
-Some methods specify known errors which can be thrown. All the known errors are enumerated in the `models/errors/errors.ts` module. The known errors for a method are documented under the *Errors* tables in SDK docs. For example, the `listProducts` method may throw the following errors:
+This table shows properties which are common on error classes. For full details see [error classes](#error-classes).
 
-| Error Type          | Status Code | Content Type     |
-| ------------------- | ----------- | ---------------- |
-| errors.Unauthorized | 401         | application/json |
-| errors.NotFound     | 404         | application/json |
-| errors.CeError      | 4XX, 5XX    | \*/\*            |
-
-If the method throws an error and it is not captured by the known errors, it will default to throwing a `CeError`.
+| Property            | Type       | Description                                                                             |
+| ------------------- | ---------- | --------------------------------------------------------------------------------------- |
+| `error.name`        | `string`   | Error class name eg `CeError`                                                           |
+| `error.message`     | `string`   | Error message                                                                           |
+| `error.statusCode`  | `number`   | HTTP status code eg `404`                                                               |
+| `error.contentType` | `string`   | HTTP content type eg `application/json`                                                 |
+| `error.body`        | `string`   | HTTP body. Can be empty string if no body is returned.                                  |
+| `error.rawResponse` | `Response` | Raw HTTP response. Access to headers and more.                                          |
+| `error.data$`       |            | Optional. Some errors may contain structured data. [See Error Classes](#error-classes). |
 
+### Example
 ```typescript
 import { CeStorefront } from "ce-storefront";
-import {
-  NotFound,
-  SDKValidationError,
-  Unauthorized,
-} from "ce-storefront/models/errors";
+import * as errors from "ce-storefront/models/errors";
 
 const ceStorefront = new CeStorefront({
   authorization: "<YOUR_BEARER_TOKEN_HERE>",
 });
 
 async function run() {
-  let result;
   try {
-    result = await ceStorefront.catalog.listProducts({
+    const result = await ceStorefront.catalog.listProducts({
       sortBy: "{\"country\":\"asc\",\"city\":\"asc\",\"population\":\"desc\"}",
     });
 
-    // Handle the result
     console.log(result);
-  } catch (err) {
-    switch (true) {
-      // The server response does not match the expected SDK schema
-      case (err instanceof SDKValidationError): {
-        // Pretty-print will provide a human-readable multi-line error message
-        console.error(err.pretty());
-        // Raw value may also be inspected
-        console.error(err.rawValue);
-        return;
-      }
-      case (err instanceof Unauthorized): {
-        // Handle err.data$: UnauthorizedData
-        console.error(err);
-        return;
-      }
-      case (err instanceof NotFound): {
-        // Handle err.data$: NotFoundData
-        console.error(err);
-        return;
-      }
-      default: {
-        // Other errors such as network errors, see HTTPClientErrors for more details
-        throw err;
-      }
+  } catch (error) {
+    // Depending on the method different errors may be thrown
+    if (error instanceof errors.Unauthorized) {
+      console.log(error.message);
+      console.log(error.data$.message); // string
+      console.log(error.data$.success); // boolean
+      console.log(error.data$.code); // string
+    }
+
+    // Fallback error class, if no other more specific error class is matched
+    if (error instanceof errors.CeError) {
+      console.log(error.message);
+      console.log(error.statusCode);
+      console.log(error.body);
+      console.log(error.rawResponse.headers);
     }
   }
 }
@@ -381,17 +366,22 @@ run();
 
 ```
 
-Validation errors can also occur when either method arguments or data returned from the server do not match the expected format. The `SDKValidationError` that is thrown as a result will capture the raw value that failed validation in an attribute called `rawValue`. Additionally, a `pretty()` method is available on this error that can be used to log a nicely formatted multi-line string since validation errors can list many issues and the plain error string may be difficult read when debugging.
-
-In some rare cases, the SDK can fail to get a response from the server or even make the request due to unexpected circumstances such as network conditions. These types of errors are captured in the `models/errors/httpclienterrors.ts` module:
-
-| HTTP Client Error                                    | Description                                          |
-| ---------------------------------------------------- | ---------------------------------------------------- |
-| RequestAbortedError                                  | HTTP request was aborted by the client               |
-| RequestTimeoutError                                  | HTTP request timed out due to an AbortSignal signal  |
-| ConnectionError                                      | HTTP client was unable to make a request to a server |
-| InvalidRequestError                                  | Any input used to create a request is invalid        |
-| UnexpectedClientError                                | Unrecognised or unexpected error                     |
+### Error Classes
+* [`Unauthorized`](docs/models/errors/unauthorized.md): Not authorized for given operation on the Resource. Status code `401`.
+* `CeError`: The fallback error class, if no other more specific error class is matched.
+* `SDKValidationError`: Type mismatch between the data returned from the server and the structure expected by the SDK. This can also be thrown for invalid method arguments. See `error.rawValue` for the raw value and `error.pretty()` for a nicely formatted multi-line string.
+* Network errors:
+    * `ConnectionError`: HTTP client was unable to make a request to a server.
+    * `RequestTimeoutError`: HTTP request timed out due to an AbortSignal signal.
+    * `RequestAbortedError`: HTTP request was aborted by the client.
+    * `InvalidRequestError`: Any input used to create a request is invalid.
+    * `UnexpectedClientError`: Unrecognised or unexpected error.
+* Less common errors, applicable to a subset of methods:
+    * [`NotFound`](docs/models/errors/notfound.md): Requested resource not found. Status code `404`. Applicable to 39 of 49 methods.*
+    * [`BadRequest`](docs/models/errors/badrequest.md): Bad request. Status code `400`. Applicable to 28 of 49 methods.*
+
+
+\* Check [the method documentation](#available-resources-and-operations) to see if the error is applicable.
 <!-- End Error Handling [errors] -->
 
 <!-- Start Server Selection [server] -->
@@ -428,7 +418,6 @@ async function run() {
     sortBy: "{\"country\":\"asc\",\"city\":\"asc\",\"population\":\"desc\"}",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -452,7 +441,6 @@ async function run() {
     sortBy: "{\"country\":\"asc\",\"city\":\"asc\",\"population\":\"desc\"}",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -534,7 +522,6 @@ async function run() {
     sortBy: "{\"country\":\"asc\",\"city\":\"asc\",\"population\":\"desc\"}",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -555,7 +542,6 @@ async function run() {
     xApiKey: "<YOUR_API_KEY_HERE>",
   });
 
-  // Handle the result
   console.log(result);
 }
 

package/docs/sdks/auth/README.md

@@ -33,7 +33,6 @@ async function run() {
     xApiKey: "<YOUR_API_KEY_HERE>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -56,15 +55,12 @@ async function run() {
   const res = await authGetAnonymousToken(ceStorefront, {
     xApiKey: "<YOUR_API_KEY_HERE>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("authGetAnonymousToken failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -109,7 +105,6 @@ async function run() {
     phone: "(553) 856-7634 x016",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -134,15 +129,12 @@ async function run() {
   const res = await authLoginWithPhone(ceStorefront, {
     phone: "(553) 856-7634 x016",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("authLoginWithPhone failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -188,7 +180,6 @@ async function run() {
     email: "Dax_Wisoky@gmail.com",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -213,15 +204,12 @@ async function run() {
   const res = await authLoginWithEmail(ceStorefront, {
     email: "Dax_Wisoky@gmail.com",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("authLoginWithEmail failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -267,7 +255,6 @@ async function run() {
     phone: "(797) 625-7467 x574",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -292,15 +279,12 @@ async function run() {
   const res = await authLoginWithWhatsapp(ceStorefront, {
     phone: "(797) 625-7467 x574",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("authLoginWithWhatsapp failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -347,7 +331,6 @@ async function run() {
     otpAction: "update-email",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -374,15 +357,12 @@ async function run() {
     otpToken: "<value>",
     otpAction: "update-email",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("authVerifyOtp failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -428,7 +408,6 @@ async function run() {
     id: "<id>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -453,15 +432,12 @@ async function run() {
   const res = await authGetUserDetail(ceStorefront, {
     id: "<id>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("authGetUserDetail failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -535,7 +511,6 @@ async function run() {
     },
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -588,15 +563,12 @@ async function run() {
       },
     },
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("authUpdateUser failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -641,7 +613,6 @@ async function run() {
     refreshToken: "<value>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -666,15 +637,12 @@ async function run() {
   const res = await authRefreshToken(ceStorefront, {
     refreshToken: "<value>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("authRefreshToken failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -720,7 +688,6 @@ async function run() {
     otpAction: "verify-email",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -746,15 +713,12 @@ async function run() {
     email: "Ahmed80@gmail.com",
     otpAction: "verify-email",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("authGenerateOtp failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -797,7 +761,6 @@ const ceStorefront = new CeStorefront({
 async function run() {
   const result = await ceStorefront.auth.logout();
 
-  // Handle the result
   console.log(result);
 }
 
@@ -820,15 +783,12 @@ const ceStorefront = new CeStorefrontCore({
 
 async function run() {
   const res = await authLogout(ceStorefront);
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("authLogout failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();