Enhance BMS functionality and add new images

- Added support for development requirements in `uv.lock`.
- Introduced new images: `example_square.jpg` and `example_wide.jpg`.
- Refactored BMS models to use `list` instead of `List` for type hints.
- Improved validation logic in `BmsCommerce` for discount handling.
- Updated tests to ensure proper assertions and added image checks for BMS wide item list.

Author: Palbahngmiyine

examples/images/example_square.jpg

@@ -1,14 +1,12 @@
-from typing import List, Optional, Union
+from typing import Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 from pydantic.alias_generators import to_camel
 
-from solapi.model.kakao.bms.bms_button import BmsAppButton, BmsWebButton
+from solapi.model.kakao.bms.bms_button import BmsLinkButton
 from solapi.model.kakao.bms.bms_commerce import BmsCommerce
 from solapi.model.kakao.bms.bms_coupon import BmsCoupon
 
-BmsLinkButton = Union[BmsWebButton, BmsAppButton]
-
 
 class BmsCarouselHead(BaseModel):
     header: Optional[str] = None
@@ -36,14 +34,14 @@ class BmsCarouselFeedItem(BaseModel):
     content: Optional[str] = None
     image_id: Optional[str] = None
     image_link: Optional[str] = None
-    buttons: Optional[List[BmsLinkButton]] = None
+    buttons: Optional[list[BmsLinkButton]] = None
     coupon: Optional[BmsCoupon] = None
 
     model_config = ConfigDict(alias_generator=to_camel, populate_by_name=True)
 
 
 class BmsCarouselFeedSchema(BaseModel):
-    items: Optional[List[BmsCarouselFeedItem]] = Field(default=None, alias="list")
+    items: Optional[list[BmsCarouselFeedItem]] = Field(default=None, alias="list")
     tail: Optional[BmsCarouselTail] = None
 
     model_config = ConfigDict(populate_by_name=True)
@@ -53,7 +51,7 @@ class BmsCarouselCommerceItem(BaseModel):
     commerce: Optional[BmsCommerce] = None
     image_id: Optional[str] = None
     image_link: Optional[str] = None
-    buttons: Optional[List[BmsLinkButton]] = None
+    buttons: Optional[list[BmsLinkButton]] = None
     additional_content: Optional[str] = None
     coupon: Optional[BmsCoupon] = None
 
@@ -62,7 +60,7 @@ class BmsCarouselCommerceItem(BaseModel):
 
 class BmsCarouselCommerceSchema(BaseModel):
     head: Optional[BmsCarouselHead] = None
-    items: Optional[List[BmsCarouselCommerceItem]] = Field(default=None, alias="list")
+    items: Optional[list[BmsCarouselCommerceItem]] = Field(default=None, alias="list")
     tail: Optional[BmsCarouselTail] = None
 
     model_config = ConfigDict(populate_by_name=True)

examples/images/example_wide.jpg

@@ -40,34 +40,28 @@ def validate_price_combination(self) -> "BmsCommerce":
         has_discount_rate = self.discount_rate is not None
         has_discount_fixed = self.discount_fixed is not None
 
-        if not has_discount_price and not has_discount_rate and not has_discount_fixed:
-            return self
-
-        if has_discount_price and has_discount_rate and not has_discount_fixed:
-            return self
-
-        if has_discount_price and has_discount_fixed and not has_discount_rate:
+        # 할인 정보 없음 = 유효
+        if not any([has_discount_price, has_discount_rate, has_discount_fixed]):
             return self
 
+        # discountRate와 discountFixed는 상호 배타적
         if has_discount_rate and has_discount_fixed:
             raise ValueError(
                 "discountRate와 discountFixed는 동시에 사용할 수 없습니다. "
                 "할인율(discountRate) 또는 정액할인(discountFixed) 중 하나만 선택하세요."
             )
 
-        if not has_discount_price and (has_discount_rate or has_discount_fixed):
-            raise ValueError(
-                "discountRate 또는 discountFixed를 사용하려면 "
-                "discountPrice(할인가)도 함께 지정해야 합니다."
-            )
-
-        if has_discount_price and not has_discount_rate and not has_discount_fixed:
-            raise ValueError(
-                "discountPrice를 사용하려면 discountRate(할인율) 또는 "
-                "discountFixed(정액할인) 중 하나를 함께 지정해야 합니다."
-            )
+        # 할인 정보는 완전한 세트여야 함 (discountPrice + discountRate/discountFixed)
+        if has_discount_price != (has_discount_rate or has_discount_fixed):
+            if has_discount_price:
+                raise ValueError(
+                    "discountPrice를 사용하려면 discountRate(할인율) 또는 "
+                    "discountFixed(정액할인) 중 하나를 함께 지정해야 합니다."
+                )
+            else:
+                raise ValueError(
+                    "discountRate 또는 discountFixed를 사용하려면 "
+                    "discountPrice(할인가)도 함께 지정해야 합니다."
+                )
 
-        raise ValueError(
-            "알 수 없는 가격 조합입니다. regularPrice만 사용하거나, "
-            "regularPrice + discountPrice + discountRate/discountFixed 조합을 사용하세요."
-        )
+        return self

solapi/model/kakao/bms/bms_carousel.py

@@ -10,38 +10,15 @@
 )
 from solapi.model.kakao.bms.bms_commerce import BmsCommerce
 from solapi.model.kakao.bms.bms_coupon import BmsCoupon
+from solapi.model.kakao.bms.bms_option import (
+    BMS_REQUIRED_FIELDS,
+    WIDE_ITEM_LIST_MIN_SUB_ITEMS,
+    BmsChatBubbleType,
+    _to_camel,
+)
 from solapi.model.kakao.bms.bms_video import BmsVideo
 from solapi.model.kakao.bms.bms_wide_item import BmsMainWideItem, BmsSubWideItem
 
-BmsChatBubbleType = Literal[
-    "TEXT",
-    "IMAGE",
-    "WIDE",
-    "WIDE_ITEM_LIST",
-    "COMMERCE",
-    "CAROUSEL_FEED",
-    "CAROUSEL_COMMERCE",
-    "PREMIUM_VIDEO",
-]
-
-BMS_REQUIRED_FIELDS: dict[BmsChatBubbleType, list[str]] = {
-    "TEXT": [],
-    "IMAGE": ["image_id"],
-    "WIDE": ["image_id"],
-    "WIDE_ITEM_LIST": ["header", "main_wide_item", "sub_wide_item_list"],
-    "COMMERCE": ["image_id", "commerce", "buttons"],
-    "CAROUSEL_FEED": ["carousel"],
-    "CAROUSEL_COMMERCE": ["carousel"],
-    "PREMIUM_VIDEO": ["video"],
-}
-
-WIDE_ITEM_LIST_MIN_SUB_ITEMS = 3
-
-
-def _to_camel(s: str) -> str:
-    components = s.split("_")
-    return components[0] + "".join(x.title() for x in components[1:])
-
 
 class Bms(BaseModel):
     targeting: Optional[Literal["I", "M", "N"]] = None