@ikas/bp-storefront 1.4.0-beta.167 → 1.4.0-beta.169

package/dist/functions/stores/cart/index.d.ts

@@ -26,6 +26,13 @@ export declare function getCheckoutUrlFromCartStore(cartStore: IkasCartStore): s
 /**
  * Add a product variant to the shopping cart.
  *
+ * Clamps the quantity to the sales channel's `minQuantityPerCart`/`maxQuantityPerCart` only
+ * when it creates a new cart line. When the variant already has a line in the cart, the add
+ * is delegated to `changeItemQuantity` (existing quantity + `initialQuantity`) with no
+ * client-side clamp — a quantity past `maxQuantityPerCart` is then rejected by the API with
+ * the `MAX_QUANTITY_PER_CART_LIMIT_REACHED` code in `result.response.errorCodes`, never as a
+ * `validationError`. See `changeItemQuantity` for the handling pattern.
+ *
  * @ai-category ProductDetail, Cart
  * @ai-related getSelectedProductVariant, findExistingCartItem, hasProductVariantStock
  *
@@ -85,6 +92,11 @@ export declare function addSelectedtedVariantToCart(product: IkasProduct, initia
  * Change the quantity of an item in the cart.
  * Use quantity=0 to remove the item.
  *
+ * Performs no client-side clamping or validation: a quantity above the sales channel's
+ * `maxQuantityPerCart` is rejected by the API with the `MAX_QUANTITY_PER_CART_LIMIT_REACHED`
+ * code in `result.response.errorCodes` (never as a `validationError`). Prevent violations in
+ * the stepper and treat the error code as the fallback.
+ *
  * @ai-category Cart
  * @ai-related removeItem, findExistingCartItem
  *
@@ -96,7 +108,7 @@ export declare function addSelectedtedVariantToCart(product: IkasProduct, initia
  *
  * @example
  * ```typescript
- * import { cartStore, changeItemQuantity } from "@ikas/bp-storefront";
+ * import { APIErrorCode, cartStore, changeItemQuantity } from "@ikas/bp-storefront";
  *
  * // Increment quantity
  * async function handleIncrement(itemId: string) {
@@ -104,7 +116,10 @@ export declare function addSelectedtedVariantToCart(product: IkasProduct, initia
  *   if (item) {
  *     const result = await changeItemQuantity(item, item.quantity + 1);
  *     if (!result.success) {
- *       showToast("Failed to update quantity");
+ *       const limitHit = result.response?.errorCodes?.includes(
+ *         APIErrorCode.MAX_QUANTITY_PER_CART_LIMIT_REACHED
+ *       );
+ *       showToast(limitHit ? "Per-cart quantity limit reached" : "Failed to update quantity");
  *     }
  *   }
  * }

package/dist/index.d.ts

@@ -26,7 +26,7 @@ export * from "./utils/fetch";
 export * from "./utils/object-wrapper";
 export * from "./utils/pay-with-ikas";
 export * from "./utils/svg";
-export type { APIErrorCode, APIResponse } from "./storefront-api/src";
+export type { APIResponse } from "./storefront-api/src";
 export * from "./storefront-api/src";
 export * from "./storefront-config/src";
 export * from "./storefront-models/src";

package/dist/packages/storefront-api-client/src/utils/api.js

@@ -1 +1 @@
-var r;!function(r){r.ARGUMENT_VALIDATION_ERROR="ARGUMENT_VALIDATION_ERROR",r.UNAUTHENTICATED="UNAUTHENTICATED",r.UNAUTHORIZED="UNAUTHORIZED",r.INTERNAL_SERVER_ERROR="INTERNAL_SERVER_ERROR",r.LOGIN_REQUIRED="LOGIN_REQUIRED",r.NETWORK_ERROR="NETWORK_ERROR",r.REQUEST_CANCELLED="REQUEST_CANCELLED",r.DUPLICATE_KEY_ERROR="DUPLICATE_KEY_ERROR",r.CUSTOMER_ALREADY_SUBSCRIBED="CUSTOMER_ALREADY_SUBSCRIBED",r.UNKNOWN="UNKNOWN"}(r||(r={}));var e=function(){function e(e,o,n){this.errors=[],this.errorCodes=[];var t=[],E=[];null==o||o.forEach(function(e){var o;(null===(o=e.extensions)||void 0===o?void 0:o.code)?(t.push(e.message),E.push(e.extensions.code)):(t.push("Unknown error"),E.push(r.UNKNOWN))}),null==n||n.forEach(function(r){E.push(r)}),this.graphQLErrors=o,this.errors=t,this.errorCodes=E,this.data=e}return Object.defineProperty(e.prototype,"firstErrorMessage",{get:function(){return this.errors.length?this.errors[0]:""},enumerable:!1,configurable:!0}),Object.defineProperty(e.prototype,"isUnAuthenticated",{get:function(){return this.errorCodes.some(function(e){return e===r.UNAUTHENTICATED})},enumerable:!1,configurable:!0}),Object.defineProperty(e.prototype,"isNetworkError",{get:function(){return this.errorCodes.some(function(e){return e===r.NETWORK_ERROR})},enumerable:!1,configurable:!0}),Object.defineProperty(e.prototype,"isSuccess",{get:function(){return 0===this.errorCodes.length},enumerable:!1,configurable:!0}),Object.defineProperty(e.prototype,"isCancelled",{get:function(){return this.errorCodes.some(function(e){return e===r.REQUEST_CANCELLED})},enumerable:!1,configurable:!0}),Object.defineProperty(e.prototype,"isRecoverableError",{get:function(){var e=[r.UNAUTHENTICATED,r.INTERNAL_SERVER_ERROR,r.NETWORK_ERROR];return this.errorCodes.every(function(r){return e.includes(r)})},enumerable:!1,configurable:!0}),e.networkError=function(){var o=new e;return o.errors.push("Network error!"),o.errorCodes.push(r.NETWORK_ERROR),o},e.requestCancelled=function(){var o=new e;return o.errors.push("Request was cancelled"),o.errorCodes.push(r.REQUEST_CANCELLED),o},e.unknownError=function(){var o=new e;return o.errors.push("Unknown error!"),o.errorCodes.push(r.UNKNOWN),o},e.authError=function(){var o=new e;return o.errors.push("Authentication error!"),o.errorCodes.push(r.UNAUTHENTICATED),o},e.success=function(){return new e},e}();function o(r){var o,n;return console.error(r.toJSON?r.toJSON():r),"AbortError"===r.name||20===r.code||(null===(o=r.message)||void 0===o?void 0:o.includes("aborted"))?e.requestCancelled():r.networkError?e.networkError():r.graphQLErrors?new e(void 0,r.graphQLErrors):r instanceof TypeError&&(null===(n=r.message)||void 0===n?void 0:n.includes("fetch"))?e.networkError():e.unknownError()}export{r as APIErrorCode,e as APIResponse,o as handleAPIError};
+var r;!function(r){r.ARGUMENT_VALIDATION_ERROR="ARGUMENT_VALIDATION_ERROR",r.UNAUTHENTICATED="UNAUTHENTICATED",r.UNAUTHORIZED="UNAUTHORIZED",r.INTERNAL_SERVER_ERROR="INTERNAL_SERVER_ERROR",r.LOGIN_REQUIRED="LOGIN_REQUIRED",r.NETWORK_ERROR="NETWORK_ERROR",r.REQUEST_CANCELLED="REQUEST_CANCELLED",r.DUPLICATE_KEY_ERROR="DUPLICATE_KEY_ERROR",r.CUSTOMER_ALREADY_SUBSCRIBED="CUSTOMER_ALREADY_SUBSCRIBED",r.MAX_QUANTITY_PER_CART_LIMIT_REACHED="MAX_QUANTITY_PER_CART_LIMIT_REACHED",r.UNKNOWN="UNKNOWN"}(r||(r={}));var e=function(){function e(e,o,n){this.errors=[],this.errorCodes=[];var t=[],E=[];null==o||o.forEach(function(e){var o;(null===(o=e.extensions)||void 0===o?void 0:o.code)?(t.push(e.message),E.push(e.extensions.code)):(t.push("Unknown error"),E.push(r.UNKNOWN))}),null==n||n.forEach(function(r){E.push(r)}),this.graphQLErrors=o,this.errors=t,this.errorCodes=E,this.data=e}return Object.defineProperty(e.prototype,"firstErrorMessage",{get:function(){return this.errors.length?this.errors[0]:""},enumerable:!1,configurable:!0}),Object.defineProperty(e.prototype,"isUnAuthenticated",{get:function(){return this.errorCodes.some(function(e){return e===r.UNAUTHENTICATED})},enumerable:!1,configurable:!0}),Object.defineProperty(e.prototype,"isNetworkError",{get:function(){return this.errorCodes.some(function(e){return e===r.NETWORK_ERROR})},enumerable:!1,configurable:!0}),Object.defineProperty(e.prototype,"isSuccess",{get:function(){return 0===this.errorCodes.length},enumerable:!1,configurable:!0}),Object.defineProperty(e.prototype,"isCancelled",{get:function(){return this.errorCodes.some(function(e){return e===r.REQUEST_CANCELLED})},enumerable:!1,configurable:!0}),Object.defineProperty(e.prototype,"isRecoverableError",{get:function(){var e=[r.UNAUTHENTICATED,r.INTERNAL_SERVER_ERROR,r.NETWORK_ERROR];return this.errorCodes.every(function(r){return e.includes(r)})},enumerable:!1,configurable:!0}),e.networkError=function(){var o=new e;return o.errors.push("Network error!"),o.errorCodes.push(r.NETWORK_ERROR),o},e.requestCancelled=function(){var o=new e;return o.errors.push("Request was cancelled"),o.errorCodes.push(r.REQUEST_CANCELLED),o},e.unknownError=function(){var o=new e;return o.errors.push("Unknown error!"),o.errorCodes.push(r.UNKNOWN),o},e.authError=function(){var o=new e;return o.errors.push("Authentication error!"),o.errorCodes.push(r.UNAUTHENTICATED),o},e.success=function(){return new e},e}();function o(r){var o,n;return console.error(r.toJSON?r.toJSON():r),"AbortError"===r.name||20===r.code||(null===(o=r.message)||void 0===o?void 0:o.includes("aborted"))?e.requestCancelled():r.networkError?e.networkError():r.graphQLErrors?new e(void 0,r.graphQLErrors):r instanceof TypeError&&(null===(n=r.message)||void 0===n?void 0:n.includes("fetch"))?e.networkError():e.unknownError()}export{r as APIErrorCode,e as APIResponse,o as handleAPIError};

package/dist/storefront-api-client/src/utils/api.d.ts

@@ -5,6 +5,12 @@ export default interface API<T> {
     saveBulk?: (models: T[]) => Promise<APIResponse<any>>;
     delete?: (idList: string[]) => Promise<APIResponse<any>>;
 }
+/**
+ * Error codes the SDK itself distinguishes. NOT exhaustive: the APIResponse
+ * constructor copies `extensions.code` from GraphQL errors verbatim, so
+ * `errorCodes` can carry backend codes that are not listed here (e.g.
+ * VARIANT_NOT_FOUND). Never build an exhaustive switch over this enum.
+ */
 export declare enum APIErrorCode {
     ARGUMENT_VALIDATION_ERROR = "ARGUMENT_VALIDATION_ERROR",
     UNAUTHENTICATED = "UNAUTHENTICATED",
@@ -15,6 +21,7 @@ export declare enum APIErrorCode {
     REQUEST_CANCELLED = "REQUEST_CANCELLED",
     DUPLICATE_KEY_ERROR = "DUPLICATE_KEY_ERROR",
     CUSTOMER_ALREADY_SUBSCRIBED = "CUSTOMER_ALREADY_SUBSCRIBED",
+    MAX_QUANTITY_PER_CART_LIMIT_REACHED = "MAX_QUANTITY_PER_CART_LIMIT_REACHED",
     UNKNOWN = "UNKNOWN"
 }
 export declare class APIResponse<T> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikas/bp-storefront",
-  "version": "1.4.0-beta.167",
+  "version": "1.4.0-beta.169",
   "description": "A framework for the ikas blueprint storefronts.",
   "author": "ikas",
   "license": "ISC",