@ikas/code-components-mcp 1.4.0-beta.175 → 1.4.0-beta.177

package/data/storefront-api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-08-24T11:34:54.069Z",
+  "generatedAt": "2026-08-28T13:39:31.656Z",
   "functions": [
     {
       "name": "apiListProductBrand",
@@ -3085,6 +3085,35 @@
         "IkasOrderGiftPackageLine"
       ]
     },
+    {
+      "name": "getIkasOrderGiftCardTotalPrice",
+      "displayName": "getGiftCardTotalPrice",
+      "signature": "function getIkasOrderGiftCardTotalPrice(order: IkasOrder): number",
+      "description": "Returns the total amount covered by the gift cards (and store credits) applied to the order or cart.\n\nThis is a derived value, the API does not return it: it sums `amount` over `order.giftCardLines`.\nSubtract it from `order.totalFinalPrice` to get the amount still due.",
+      "params": [
+        {
+          "name": "order",
+          "description": "- The IkasOrder or IkasCart holding the gift card lines"
+        }
+      ],
+      "returns": "The summed gift card amount, or 0 when no gift card is applied",
+      "returnType": "number",
+      "example": "```typescript\nimport { getIkasOrderGiftCardTotalPrice } from \"@ikas/bp-storefront\";\n\nconst giftCardTotal = getIkasOrderGiftCardTotalPrice(cart);\nconst remainingPrice = cart.totalFinalPrice - giftCardTotal;\n```",
+      "categories": [
+        "Order",
+        "Cart"
+      ],
+      "related": [
+        "removeGiftCardLine",
+        "saveCouponCode"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasOrderGiftCardTotalPrice",
+        "IkasOrder"
+      ]
+    },
     {
       "name": "getIkasOrderDistinctItemCount",
       "displayName": "getDistinctItemCount",
@@ -13168,6 +13197,37 @@
         "IkasCartOperationResult"
       ]
     },
+    {
+      "name": "removeGiftCardLine",
+      "signature": "async function removeGiftCardLine(cart: IkasCart, giftCardId?: string | null): Promise<IkasCartOperationResult>",
+      "description": "Remove a gift card (or store credit) line from the cart.\n\nGift cards are applied through `saveCouponCode` with the gift card code, and the applied\ncards are listed on `cart.giftCardLines`. Pass the `giftCardId` of the line to remove; when\nomitted, every gift card line is removed from the cart.",
+      "params": [
+        {
+          "name": "cart",
+          "description": "- The cart object"
+        },
+        {
+          "name": "giftCardId",
+          "description": "- The gift card to remove, or null/undefined to remove all of them"
+        }
+      ],
+      "returns": "Result with success flag",
+      "returnType": "Promise<IkasCartOperationResult>",
+      "example": "```typescript\nimport { cartStore, removeGiftCardLine } from \"@ikas/bp-storefront\";\n\nasync function handleRemoveGiftCard(giftCardId: string) {\n  if (!cartStore.cart) return;\n\n  const result = await removeGiftCardLine(cartStore.cart, giftCardId);\n  if (result.success) {\n    showToast(\"Gift card removed\");\n  }\n}\n```",
+      "categories": [
+        "Cart"
+      ],
+      "related": [
+        "saveCouponCode",
+        "getIkasOrderGiftCardTotalPrice"
+      ],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasCart",
+        "IkasCartOperationResult"
+      ]
+    },
     {
       "name": "getCart",
       "signature": "async function getCart(): Promise<void>",

package/data/storefront-types.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-08-24T11:34:54.098Z",
+  "generatedAt": "2026-08-28T13:39:31.696Z",
   "types": [
     {
       "name": "TextElementTagTypes",
@@ -2467,6 +2467,7 @@
         "findExistingCartItemWithProduct",
         "saveCouponCode",
         "removeCouponCode",
+        "removeGiftCardLine",
         "setCart"
       ]
     },
@@ -6320,6 +6321,77 @@
         "hasIkasOrderCustomer"
       ]
     },
+    {
+      "name": "IkasOrderGiftCardLine",
+      "kind": "type",
+      "domain": "order",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "amount",
+          "type": "number",
+          "optional": false
+        },
+        {
+          "name": "code",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "giftCardId",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "type",
+          "type": "IkasGiftCardType | null",
+          "optional": false
+        },
+        {
+          "name": "appliedTransactions",
+          "type": "IkasOrderGiftCardLineAppliedTransaction[]",
+          "optional": false
+        }
+      ],
+      "filePath": "order/gift-card-line/index.ts"
+    },
+    {
+      "name": "IkasOrderGiftCardLineAppliedTransaction",
+      "kind": "type",
+      "domain": "order",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "amount",
+          "type": "number",
+          "optional": false
+        },
+        {
+          "name": "type",
+          "type": "IkasTransactionType",
+          "optional": false
+        }
+      ],
+      "filePath": "order/gift-card-line/index.ts"
+    },
+    {
+      "name": "IkasGiftCardType",
+      "kind": "type",
+      "domain": "order",
+      "unionValues": [
+        "GIFT_CARD",
+        "STORE_CREDIT"
+      ],
+      "filePath": "order/gift-card-line/index.ts"
+    },
     {
       "name": "IkasOrderGiftPackageLine",
       "kind": "type",
@@ -6411,6 +6483,11 @@
           "type": "string | null",
           "optional": false
         },
+        {
+          "name": "giftCardLines",
+          "type": "IkasOrderGiftCardLine[] | null",
+          "optional": false
+        },
         {
           "name": "giftPackageLines",
           "type": "IkasOrderGiftPackageLine[] | null",
@@ -6524,6 +6601,7 @@
       ],
       "filePath": "order/index.ts",
       "relatedFunctions": [
+        "getIkasOrderGiftCardTotalPrice",
         "getIkasOrderDistinctItemCount",
         "getIkasOrderTotalItemCount",
         "getIkasOrderDisplayedPackages",

package/package.json

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