@ikas/bp-storefront 1.4.0-beta.131 → 1.4.0-beta.133

package/dist/functions/models/product/variant/index.d.ts

@@ -724,14 +724,25 @@ export declare function getProductVariantCampaignOffersDiscountPercentage(varian
  * A tiered discount defines multiple quantity tiers (`campaign.tieredDiscount.rules`), each with its own
  * amount and quantity range. This resolves every tier against the variant's price and returns the
  * per-tier sell/final prices (both raw numbers and formatted strings), matching the storefront runtime.
+ * The raw rules are `IkasProductTieredDiscountRule` (ranges may be null); this function returns the
+ * resolved `IkasTieredDiscountProduct` with normalized `{ min, max }` — use the resolved shape, not the raw rule.
+ *
+ * `sellPrice`/`finalPrice` (and their `formatted*` variants) are PER UNIT; the `*WithQuantity` fields are the
+ * tier total for buying the minimum quantity. A `"FIXED_AMOUNT"` discount is applied only to that total, so
+ * per-unit `finalPrice` equals `sellPrice` and the saving shows only in `finalPriceWithQuantity`.
  *
  * The discount `amount` is interpreted by `campaign.type`: `"RATIO"` treats it as a percentage,
- * `"FIXED_AMOUNT"` as an absolute money amount subtracted from the tier total.
+ * `"FIXED_AMOUNT"` as an absolute money amount subtracted from the tier total. `amount`/`type` are
+ * informational — the discount is already applied in the resolved `*Price` fields, so prefer those over
+ * recomputing it yourself.
  *
  * `lineItemQuantityRange.min`/`max` are normalized numbers where `0` means "unbounded". In particular
  * `max === 0` marks an open-ended top tier (e.g. "6+" with no upper limit) — render it as "min+" rather
  * than "min–max", and never treat `max` as a real quantity when it is `0`.
  *
+ * Each tier's `salesChannelIds` lists the channels it targets (empty/null = all channels). Filter tiers
+ * against `IkasStorefrontConfig.salesChannelId` so only those valid for the current storefront are shown.
+ *
  * Returns an empty array when the variant has no tiered-discount campaign, when a
  * `PRODUCT_AND_VARIANT` filter excludes this variant, or when no tier defines a quantity range.
  *
@@ -743,23 +754,36 @@ export declare function getProductVariantCampaignOffersDiscountPercentage(varian
  *
  * @example
  * ```typescript
- * import { getProductVariantTieredDiscountProducts, getSelectedProductVariant } from "@ikas/bp-storefront";
+ * import {
+ *   getProductVariantTieredDiscountProducts,
+ *   getSelectedProductVariant,
+ *   IkasStorefrontConfig,
+ * } from "@ikas/bp-storefront";
  * import { IkasProduct } from "@ikas/bp-storefront";
  *
  * function TieredDiscountTable({ product }: { product: IkasProduct }) {
  *   const variant = getSelectedProductVariant(product);
  *   const tiers = getProductVariantTieredDiscountProducts(variant);
+ *   const salesChannelId = IkasStorefrontConfig.salesChannelId;
  *
  *   if (!tiers.length) return null;
  *
  *   return (
  *     <ul>
- *       {tiers.map((tier, i) => (
- *         <li key={i}>
- *           Buy {tier.lineItemQuantityRange.min}+ → {tier.formattedFinalPriceWithQuantity}{" "}
- *           <s>{tier.formattedSellPriceWithQuantity}</s>
- *         </li>
- *       ))}
+ *       {tiers.map((tier, i) => {
+ *         // A tier applies when it targets no channels or includes the current one
+ *         const scoped =
+ *           !tier.salesChannelIds?.length ||
+ *           (!!salesChannelId && tier.salesChannelIds.includes(salesChannelId));
+ *         if (!scoped) return null;
+ *
+ *         return (
+ *           <li key={i}>
+ *             Buy {tier.lineItemQuantityRange.min}+ → {tier.formattedFinalPriceWithQuantity}{" "}
+ *             <s>{tier.formattedSellPriceWithQuantity}</s>
+ *           </li>
+ *         );
+ *       })}
  *     </ul>
  *   );
  * }

package/package.json

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