@ikas/code-components-mcp 1.4.0-beta.127 → 1.4.0-beta.129

package/data/storefront-api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-07-21T07:39:00.595Z",
+  "generatedAt": "2026-07-21T10:59:47.347Z",
   "functions": [
     {
       "name": "apiListProductBrand",
@@ -7597,14 +7597,14 @@
       "name": "getProductVariantAppliedCampaignAmount",
       "displayName": "getAppliedCampaignAmount",
       "signature": "function getProductVariantAppliedCampaignAmount(variant: IkasProductVariant): IkasAppliedCampaignAmount | null",
-      "description": "Get the applied campaign discount amount details for a product variant, including type and formatted value.",
+      "description": "Get the applied campaign discount amount details for a product variant, including type and formatted value.\n\nHow the discount value is interpreted depends on `campaign.type`:\n- `\"FIXED_AMOUNT\"` → the value is an absolute money amount, returned in `formattedPrice` (e.g. \"$10.00\"); `discountPercentage` stays null.\n- `\"RATIO\"` → the value is a percentage, returned in `discountPercentage` (e.g. \"10\" for 10% off); `formattedPrice` stays null.\n\nBoth fixed and tiered campaigns are supported. For a tiered-discount campaign\n(`campaign.fixedDiscount` is null and the discount lives in `campaign.tieredDiscount.rules`),\nthe first tier's amount (`campaign.tieredDiscount.rules[0].amount`) is used, matching the storefront runtime.",
       "params": [
         {
           "name": "variant",
           "description": "- The product variant to check for applied campaigns"
         }
       ],
-      "returns": "An object with campaign type, formatted price, and discount percentage, or null if no campaign is applied",
+      "returns": "An object `{ type, formattedPrice, discountPercentage }` — `formattedPrice` is set for FIXED_AMOUNT campaigns, `discountPercentage` for RATIO campaigns (fixed and tiered alike); the other field stays null. Returns null if no campaign is applied.",
       "returnType": "IkasAppliedCampaignAmount | null",
       "example": "```typescript\nimport { getProductVariantAppliedCampaignAmount, getSelectedProductVariant } from \"@ikas/bp-storefront\";\nimport { IkasProduct } from \"@ikas/bp-storefront\";\n\nfunction CampaignInfo({ product }: { product: IkasProduct }) {\n  const variant = getSelectedProductVariant(product);\n  const campaignAmount = getProductVariantAppliedCampaignAmount(variant);\n\n  if (!campaignAmount) return null;\n\n  return (\n    <div>\n      {campaignAmount.type === \"RATIO\"\n        ? `${campaignAmount.discountPercentage}% off`\n        : `${campaignAmount.formattedPrice} off`}\n    </div>\n  );\n}\n```",
       "categories": [
@@ -7999,6 +7999,36 @@
         "IkasProductVariant"
       ]
     },
+    {
+      "name": "getProductVariantTieredDiscountProducts",
+      "displayName": "getTieredDiscountProducts",
+      "signature": "function getProductVariantTieredDiscountProducts(variant: IkasProductVariant): IkasTieredDiscountProduct[]",
+      "description": "Get the tiered-discount breakdown for a product variant, one entry per discount tier.\n\nA tiered discount defines multiple quantity tiers (`campaign.tieredDiscount.rules`), each with its own\namount and quantity range. This resolves every tier against the variant's price and returns the\nper-tier sell/final prices (both raw numbers and formatted strings), matching the storefront runtime.\n\nThe discount `amount` is interpreted by `campaign.type`: `\"RATIO\"` treats it as a percentage,\n`\"FIXED_AMOUNT\"` as an absolute money amount subtracted from the tier total.\n\nReturns an empty array when the variant has no tiered-discount campaign, when a\n`PRODUCT_AND_VARIANT` filter excludes this variant, or when no tier defines a quantity range.",
+      "params": [
+        {
+          "name": "variant",
+          "description": "- The product variant to resolve tiered discounts for"
+        }
+      ],
+      "returns": "An array of tier objects (`amount`, `lineItemQuantityRange`, `type`, sell/final prices with their formatted variants, `salesChannelIds`), or an empty array if no tiered discount applies",
+      "returnType": "IkasTieredDiscountProduct[]",
+      "example": "```typescript\nimport { getProductVariantTieredDiscountProducts, getSelectedProductVariant } from \"@ikas/bp-storefront\";\nimport { IkasProduct } from \"@ikas/bp-storefront\";\n\nfunction TieredDiscountTable({ product }: { product: IkasProduct }) {\n  const variant = getSelectedProductVariant(product);\n  const tiers = getProductVariantTieredDiscountProducts(variant);\n\n  if (!tiers.length) return null;\n\n  return (\n    <ul>\n      {tiers.map((tier, i) => (\n        <li key={i}>\n          Buy {tier.lineItemQuantityRange.min}+ → {tier.formattedFinalPriceWithQuantity}{\" \"}\n          <s>{tier.formattedSellPriceWithQuantity}</s>\n        </li>\n      ))}\n    </ul>\n  );\n}\n```",
+      "categories": [
+        "Pricing",
+        "ProductVariant"
+      ],
+      "related": [
+        "getProductVariantAppliedCampaignAmount",
+        "getProductVariantCampaignOffersDiscountPercentage",
+        "getProductVariantFinalPrice"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasProductVariant",
+        "IkasTieredDiscountProduct"
+      ]
+    },
     {
       "name": "getProductVariantIsBackInStockEnabled",
       "displayName": "isBackInStockEnabled",

package/data/storefront-types.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-07-21T07:39:00.632Z",
+  "generatedAt": "2026-07-21T10:59:47.371Z",
   "types": [
     {
       "name": "TextElementTagTypes",
@@ -10946,6 +10946,7 @@
         "getProductVariantSellPriceWithCampaignOffers",
         "getProductVariantFormattedSellPriceWithCampaignOffers",
         "getProductVariantCampaignOffersDiscountPercentage",
+        "getProductVariantTieredDiscountProducts",
         "getProductVariantIsBackInStockEnabled",
         "getProductVariantIsBackInStockCustomerLoginRequired",
         "saveProductVariantBackInStockReminder",
@@ -10983,6 +10984,77 @@
         "getProductVariantAppliedCampaignAmount"
       ]
     },
+    {
+      "name": "IkasTieredDiscountProduct",
+      "kind": "type",
+      "domain": "product",
+      "properties": [
+        {
+          "name": "amount",
+          "type": "number | null",
+          "optional": false
+        },
+        {
+          "name": "lineItemQuantityRange",
+          "type": "{ min: number; max: number }",
+          "optional": false
+        },
+        {
+          "name": "type",
+          "type": "IkasCampaignType",
+          "optional": false
+        },
+        {
+          "name": "sellPrice",
+          "type": "number",
+          "optional": false
+        },
+        {
+          "name": "finalPrice",
+          "type": "number",
+          "optional": false
+        },
+        {
+          "name": "sellPriceWithQuantity",
+          "type": "number",
+          "optional": false
+        },
+        {
+          "name": "finalPriceWithQuantity",
+          "type": "number",
+          "optional": false
+        },
+        {
+          "name": "formattedSellPrice",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "formattedSellPriceWithQuantity",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "formattedFinalPrice",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "formattedFinalPriceWithQuantity",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "salesChannelIds",
+          "type": "string[] | null",
+          "optional": false
+        }
+      ],
+      "filePath": "product/variant/index.ts",
+      "relatedFunctions": [
+        "getProductVariantTieredDiscountProducts"
+      ]
+    },
     {
       "name": "IkasProductPrice",
       "kind": "type",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikas/code-components-mcp",
-  "version": "1.4.0-beta.127",
+  "version": "1.4.0-beta.129",
   "description": "MCP server for ikas code components documentation",
   "type": "module",
   "main": "dist/index.js",