@usethrottle/cart 3.2.0 → 3.3.0

package/README.md

@@ -194,6 +194,33 @@ try {
 }
 ```
 
+`ThrottleApiError` extends the shared **`ThrottleError`** from
+[`@usethrottle/errors`](https://www.npmjs.com/package/@usethrottle/errors),
+re-exported here. If you use more than one Throttle SDK you can catch all of
+their errors with a single check — `instanceof ThrottleApiError` keeps working:
+
+```ts
+import { ThrottleError } from '@usethrottle/cart'; // same class across every SDK
+
+try {
+  await cart.items.add(cartId, item);
+  await checkout.completeSession(sessionId, payment);
+} catch (e) {
+  if (e instanceof ThrottleError) {
+    console.error(e.statusCode, e.code, e.message);
+  }
+}
+```
+
+### Line item `imageUrl`
+
+`imageUrl` accepts an absolute `http(s)` URL **or** a relative path like
+`/images/x.png`. Relative paths are resolved to an absolute URL against your
+application's storefront base URL so the image renders on the hosted checkout —
+set it with `PUT /v1/embed-config { "storefrontBaseUrl": "https://yourstore.com" }`
+(the first `allowedOrigin` is used as a fallback). A relative path with no
+resolvable base returns `400 image_url_unresolvable`.
+
 ## Client options
 
 | Option      | Default                       | Description                                                 |

package/dist/index.cjs

@@ -22,21 +22,19 @@ var index_exports = {};
 __export(index_exports, {
   CartClient: () => CartClient,
   StorefrontQuoteClient: () => StorefrontQuoteClient,
-  ThrottleApiError: () => ThrottleApiError
+  ThrottleApiError: () => ThrottleApiError,
+  ThrottleError: () => import_errors2.ThrottleError,
+  isThrottleError: () => import_errors2.isThrottleError
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/errors.ts
-var ThrottleApiError = class extends Error {
-  code;
-  statusCode;
-  details;
+var import_errors = require("@usethrottle/errors");
+var import_errors2 = require("@usethrottle/errors");
+var ThrottleApiError = class extends import_errors.ThrottleError {
   constructor(args) {
-    super(args.message);
+    super(args);
     this.name = "ThrottleApiError";
-    this.code = args.code;
-    this.statusCode = args.statusCode;
-    this.details = args.details;
   }
 };
 
@@ -193,5 +191,7 @@ var StorefrontQuoteClient = class {
 0 && (module.exports = {
   CartClient,
   StorefrontQuoteClient,
-  ThrottleApiError
+  ThrottleApiError,
+  ThrottleError,
+  isThrottleError
 });

package/dist/index.d.cts

@@ -1,3 +1,6 @@
+import { ThrottleError } from '@usethrottle/errors';
+export { ThrottleError, isThrottleError } from '@usethrottle/errors';
+
 interface Cart {
     id: string;
     workspaceId: string;
@@ -359,9 +362,14 @@ declare class StorefrontQuoteClient {
     quote(input: ShippingTaxQuoteInput): Promise<ShippingTaxCalculationResponse>;
 }
 
-declare class ThrottleApiError extends Error {
-    readonly code: string;
-    readonly statusCode: number;
+/**
+ * Thrown on a non-2xx response from the Throttle Cart API.
+ *
+ * Extends the shared {@link ThrottleError} so a single
+ * `catch (e) { if (e instanceof ThrottleError) … }` covers errors from every
+ * Throttle SDK. `instanceof ThrottleApiError` keeps working for existing code.
+ */
+declare class ThrottleApiError extends ThrottleError {
     readonly details?: Record<string, unknown>;
     constructor(args: {
         code: string;

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import { ThrottleError } from '@usethrottle/errors';
+export { ThrottleError, isThrottleError } from '@usethrottle/errors';
+
 interface Cart {
     id: string;
     workspaceId: string;
@@ -359,9 +362,14 @@ declare class StorefrontQuoteClient {
     quote(input: ShippingTaxQuoteInput): Promise<ShippingTaxCalculationResponse>;
 }
 
-declare class ThrottleApiError extends Error {
-    readonly code: string;
-    readonly statusCode: number;
+/**
+ * Thrown on a non-2xx response from the Throttle Cart API.
+ *
+ * Extends the shared {@link ThrottleError} so a single
+ * `catch (e) { if (e instanceof ThrottleError) … }` covers errors from every
+ * Throttle SDK. `instanceof ThrottleApiError` keeps working for existing code.
+ */
+declare class ThrottleApiError extends ThrottleError {
     readonly details?: Record<string, unknown>;
     constructor(args: {
         code: string;

package/dist/index.js

@@ -1,14 +1,10 @@
 // src/errors.ts
-var ThrottleApiError = class extends Error {
-  code;
-  statusCode;
-  details;
+import { ThrottleError } from "@usethrottle/errors";
+import { ThrottleError as ThrottleError2, isThrottleError } from "@usethrottle/errors";
+var ThrottleApiError = class extends ThrottleError {
   constructor(args) {
-    super(args.message);
+    super(args);
     this.name = "ThrottleApiError";
-    this.code = args.code;
-    this.statusCode = args.statusCode;
-    this.details = args.details;
   }
 };
 
@@ -164,5 +160,7 @@ var StorefrontQuoteClient = class {
 export {
   CartClient,
   StorefrontQuoteClient,
-  ThrottleApiError
+  ThrottleApiError,
+  ThrottleError2 as ThrottleError,
+  isThrottleError
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/cart",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Typed REST client for the Throttle Cart API.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -17,6 +17,9 @@
     "dist",
     "README.md"
   ],
+  "dependencies": {
+    "@usethrottle/errors": "^1.0.0"
+  },
   "devDependencies": {
     "tsup": "^8.0.0",
     "vitest": "^2.1.9",