line-message-builder 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa7a2c0c112ef20086d81a2c1cf4b1c430ffe291c07ccfc92dfe8d81db1ea980
-  data.tar.gz: 163eb284640eeec1e5a035492ebca95b34d703d372f5d472e4330a762d7b2ceb
+  metadata.gz: 8051ec09aa3f71ec93dc5cbe685610fd6fe6d5c4a3b086f5b5ddbef6b98e7c3c
+  data.tar.gz: cd043754cc232ed8b4e8cec6751413bf2f87e9cd3ea4b23f521346cb1ca7a86d
 SHA512:
-  metadata.gz: bcadb195ad72f851fcc648f6641ab547fc2a1885583f64be97f08288f43025246d2a14dd311103a5c64521e636dfb2bd0f89f61deccedec75ebe8bebdc528d2c
-  data.tar.gz: 1d612904e46b6e3e87590edf414b7839fa18412fe1c4734cdb961aacc8c1ed2e87a87a425b3cf563cc1eff4ec7337deaf0ff81592b75520dabba78363ec67629
+  metadata.gz: 4d951b1938f6a27ad366e5b4f08e1de7496c5d130ac95e40d4f15c2ca86a928a19a5cfb46184d958dae6afd664dfa68d4c50a2d7e00c172445e42205e3987abc
+  data.tar.gz: 802c37d5e9d2beb7f641046bf8223e9a4fc26290b5e9f1a5a07b1754027509b1b2b63952be93622908674d14321fe9c4cceea770aaf2d56684caaa94b1bb7d69

data/.release-please-manifest.json

@@ -1 +1 @@
-{".":"0.3.0"}
+{".":"0.5.0"}

data/.rspec

@@ -1,3 +1,5 @@
 --format documentation
+--format RspecJunitFormatter
+--out junit.xml
 --color
 --require spec_helper

data/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [0.5.0](https://github.com/elct9620/line-message-builder/compare/v0.4.0...v0.5.0) (2025-04-07)
+
+
+### Features
+
+* Add Actionable module for flex components with message and postback actions ([9ac4b4a](https://github.com/elct9620/line-message-builder/commit/9ac4b4af591450e8f1925814b5a57e893ffa15db))
+* Add enum validator for flex text alignment options ([540c58d](https://github.com/elct9620/line-message-builder/commit/540c58d94731adfe91d30e006bb0ee6714755006))
+* Add justify_content and align_items options to Flex Box builder ([6c2015f](https://github.com/elct9620/line-message-builder/commit/6c2015f0a75a0f541cb52fef647e0bff1a245a28))
+* Add layout validation for flex box with enum validator ([b1ecba1](https://github.com/elct9620/line-message-builder/commit/b1ecba160db03f94aaebc83b82158e75292c94eb))
+* Add margin support for flex components in Line message builder ([36043b8](https://github.com/elct9620/line-message-builder/commit/36043b8d7390cb13d60174759fc5906a70aa2507))
+* Add offset positioning support for flex message components ([1e28336](https://github.com/elct9620/line-message-builder/commit/1e2833656083aa72b0cfffccd5636e80ae41ccc9))
+* Add padding support for flex box components with validation ([9dcd9d2](https://github.com/elct9620/line-message-builder/commit/9dcd9d20a48aed023440a2abe24e8b44eea8b425))
+* Add padding support for Line Flex buttons with validation ([ca25a11](https://github.com/elct9620/line-message-builder/commit/ca25a1192c0d611ae064f935fc9335640d123b2d))
+* Add SimpleCov Cobertura formatter for CI coverage reporting ([bb5bfc8](https://github.com/elct9620/line-message-builder/commit/bb5bfc8344c1b448e61a2857aa36e1f6b5ce0425))
+* Add validator for spacing option in flex box builder ([06e7b98](https://github.com/elct9620/line-message-builder/commit/06e7b9805f8243c51faaf9c13c264ffb1f35091c))
+* Add vertical positioning support for Flex message components ([f9ce97b](https://github.com/elct9620/line-message-builder/commit/f9ce97b666cabe47717cdd916722121372cb9bf0))
+
+
+### Bug Fixes
+
+* Correct indentation in GitHub Actions workflow file ([1c1cd2d](https://github.com/elct9620/line-message-builder/commit/1c1cd2dfe2e48bd937a04ac25f7b2b772e02e1a6))
+
+## [0.4.0](https://github.com/elct9620/line-message-builder/compare/v0.3.0...v0.4.0) (2025-04-06)
+
+
+### Features
+
+* Add flex and margin options to Line Flex Button with improved error handling ([c8cd142](https://github.com/elct9620/line-message-builder/commit/c8cd1427528d5495d13bf93898da4638588065ae))
+* Add flex box options and validation for LINE message builder ([133f87d](https://github.com/elct9620/line-message-builder/commit/133f87ddb3fd2a093947db0aef6363cd4c150701))
+* Add flex bubble options and RSpec matcher for Line message builder ([605ad89](https://github.com/elct9620/line-message-builder/commit/605ad89870a53c55182f96db5f2738b5c347f0dc))
+* Add margin option to flex text builder ([1d44522](https://github.com/elct9620/line-message-builder/commit/1d44522a44218bedab3d2009ef483ed112784248))
+* Add quote token support for Line text messages ([7871999](https://github.com/elct9620/line-message-builder/commit/7871999dfc7032e75e5407c8b16bed7ef7dd28b8))
+* Add support for flex, margin, and align options in Flex image builder ([693d0ab](https://github.com/elct9620/line-message-builder/commit/693d0abf5ef524b2e6d075f3c7e65eca49cf7f27))
+
 ## [0.3.0](https://github.com/elct9620/line-message-builder/compare/v0.2.0...v0.3.0) (2025-04-05)
 
 

data/README.md

@@ -1,7 +1,16 @@
 # LINE Message Builder
 
+[![.github/workflows/main.yml](https://github.com/elct9620/line-message-builder/actions/workflows/main.yml/badge.svg)](https://github.com/elct9620/line-message-builder/actions/workflows/main.yml)
+[![codecov](https://codecov.io/gh/elct9620/line-message-builder/graph/badge.svg?token=9TJTSRIL0X)](https://codecov.io/gh/elct9620/line-message-builder)
+
 Build LINE messages using DSL (Domain Specific Language) in Ruby.
 
+## Features
+
+- Build LINE messages using DSL
+- Validation of properties
+- RSpec matchers for testing
+
 ## Installation
 
 Install the gem and add to the application's Gemfile by executing:
@@ -95,6 +104,7 @@ end
 | --------------------------- | ------------------------------------ |
 | `have_line_text_message`    | Match a text message                 |
 | `have_line_flex_message`    | Match a flex message                 |
+| `have_line_flex_bubble`     | Match a flex message with bubble     |
 | `have_line_flex_text`       | Match a flex message with text       |
 | `have_line_flex_image`      | Match a flex message with image      |
 | `have_line_flex_button`     | Match a flex message with button     |
@@ -154,7 +164,7 @@ end
 
 | Type     | Supported |
 | ----     | --------- |
-| Text     | ✅        |
+| Text     | 🚧        |
 | Text v2  | ❌        |
 | Sticker  | ❌        |
 | Sticker  | ❌        |
@@ -189,19 +199,19 @@ end
 
 ### Flex Components
 
-| Component | Supported |
-| --------- | --------- |
-| Bubble    | 🚧        |
-| Carousel  | ❌        |
-| Box       | 🚧        |
-| Button    | 🚧        |
-| Image     | 🚧        |
-| Video     | ❌        |
-| Icon      | ❌        |
-| Text      | 🚧        |
-| Span      | ❌        |
-| Separator | ❌        |
-| Filler    | ❌        |
+| Component | Supported     |
+| --------- | ---------     |
+| Bubble    | 🚧            |
+| Carousel  | ❌            |
+| Box       | 🚧            |
+| Button    | 🚧            |
+| Image     | 🚧            |
+| Video     | ❌            |
+| Icon      | ❌            |
+| Text      | 🚧            |
+| Span      | ❌            |
+| Separator | ❌            |
+| Filler    | ❌ Deprecated |
 
 ## Development
 

data/lib/line/message/builder/actions/message.rb

@@ -6,26 +6,23 @@ module Line
       module Actions
         # The Message class is used to build message actions for quick replies.
         class Message < Line::Message::Builder::Base
-          def initialize(text: nil, label: nil, context: nil, &)
-            @text = text
-            @label = label
-
-            super(context: context, &)
-          end
+          attr_reader :text
 
-          def label(label)
-            @label = label
-          end
+          option :label, default: nil
 
-          def text(text)
+          def initialize(text, context: nil, **options, &)
             @text = text
+
+            super(context: context, **options, &)
           end
 
           def to_h
+            raise RequiredError, "text is required" if text.nil?
+
             {
               type: "message",
-              label: @label,
-              text: @text
+              label: label,
+              text: text
             }.compact
           end
         end

data/lib/line/message/builder/actions/postback.rb

@@ -6,32 +6,25 @@ module Line
       module Actions
         # The Postback class is used to build postback actions for quick replies.
         class Postback < Line::Message::Builder::Base
-          def initialize(data: nil, label: nil, display_text: nil, context: nil, &)
-            @data = data
-            @label = label
-            @display_text = display_text
-
-            super(context: context, &)
-          end
+          attr_reader :data
 
-          def label(label)
-            @label = label
-          end
+          option :label, default: nil
+          option :display_text, default: nil
 
-          def data(data)
+          def initialize(data, context: nil, **options, &)
             @data = data
-          end
 
-          def display_text(display_text)
-            @display_text = display_text
+            super(context: context, **options, &)
           end
 
           def to_h
+            raise RequiredError, "data is required" if data.nil?
+
             {
               type: "postback",
-              label: @label,
-              data: @data,
-              displayText: @display_text
+              label: label,
+              data: data,
+              displayText: display_text
             }.compact
           end
         end

data/lib/line/message/builder/base.rb

@@ -18,13 +18,14 @@ module Line
             @options ||= []
           end
 
-          def option(name, default: nil)
+          def option(name, default: nil, validator: nil)
             options << name
 
             define_method name do |*args|
               if args.empty?
                 instance_variable_get("@#{name}") || default
               else
+                validator&.valid!(args.first)
                 instance_variable_set("@#{name}", args.first)
               end
             end
@@ -38,7 +39,7 @@ module Line
           @quick_reply = nil
 
           self.class.options.each do |option|
-            instance_variable_set("@#{option}", options[option]) if options.key?(option)
+            send(option, options[option]) if options.key?(option)
           end
 
           instance_eval(&block) if ::Kernel.block_given?

data/lib/line/message/builder/container.rb

@@ -13,12 +13,12 @@ module Line
           super
         end
 
-        def text(text, &)
-          @messages << Text.new(text, context: context, &)
+        def text(text, **options, &)
+          @messages << Text.new(text, context: context, **options, &)
         end
 
-        def flex(**args, &)
-          @messages << Flex::Builder.new(**args, context: context, &)
+        def flex(**options, &)
+          @messages << Flex::Builder.new(context: context, **options, &)
         end
 
         def build

data/lib/line/message/builder/flex/actionable.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Line
+  module Message
+    module Builder
+      module Flex
+        # The action DSL for flex components.
+        module Actionable
+          def self.included(base)
+            base.attr_reader :action
+          end
+
+          def message(text, **options, &)
+            @action = Actions::Message.new(text, context: context, **options, &)
+          end
+
+          def postback(data, **options, &)
+            @action = Actions::Postback.new(data, context: context, **options, &)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/line/message/builder/flex/box.rb

@@ -6,7 +6,24 @@ module Line
       module Flex
         # The box is a component for the Flex message.
         class Box < Line::Message::Builder::Base
-          option :layout, default: :horizontal
+          include Actionable
+          include Position::Padding
+          include Position::Margin
+          include Position::Offset
+
+          attr_reader :contents
+
+          option :layout, default: :horizontal, validator: Validators::Enum.new(
+            :horizontal, :vertical, :baseline
+          )
+          option :justify_content, default: nil, validator: Validators::Enum.new(
+            :flex_start, :center, :flex_end, :space_between, :space_around, :space_evenly
+          )
+          option :align_items, default: nil, validator: Validators::Enum.new(
+            :flex_start, :center, :flex_end
+          )
+          option :spacing, default: nil, validator: Validators::Size.new
+          option :flex, default: nil
 
           def initialize(context: nil, **options, &)
             @contents = []
@@ -30,11 +47,33 @@ module Line
             @contents << Flex::Image.new(url, context: context, **options, &)
           end
 
-          def to_h
+          def to_h # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+            raise RequiredError, "layout is required" if layout.nil?
+
             {
               type: "box",
-              layout: @layout,
-              contents: @contents.map(&:to_h)
+              layout: layout,
+              # Position
+              justifyContent: justify_content,
+              alignItems: align_items,
+              spacing: spacing,
+              # Position::Padding
+              paddingAll: padding,
+              paddingTop: padding_top,
+              paddingBottom: padding_bottom,
+              paddingStart: padding_start,
+              paddingEnd: padding_end,
+              # Position::Margin
+              margin: margin,
+              # Position::Offset
+              position: position,
+              offsetTop: offset_top,
+              offsetBottom: offset_bottom,
+              offsetStart: offset_start,
+              offsetEnd: offset_end,
+              flex: flex,
+              contents: contents.map(&:to_h),
+              action: action&.to_h
             }.compact
           end
         end

data/lib/line/message/builder/flex/bubble.rb

@@ -6,7 +6,10 @@ module Line
       module Flex
         # The bubble is container for the Flex message.
         class Bubble < Line::Message::Builder::Base
-          def initialize(context: nil, &)
+          option :size, default: nil
+          option :styles, default: nil
+
+          def initialize(context: nil, **options, &)
             @header = nil
             @hero = nil
             @body = nil
@@ -41,7 +44,9 @@ module Line
               header: @header&.to_h,
               hero: @hero&.to_h,
               body: @body&.to_h,
-              footer: @footer&.to_h
+              footer: @footer&.to_h,
+              size: size,
+              styles: styles
             }.compact
           end
         end

data/lib/line/message/builder/flex/builder.rb

@@ -14,8 +14,8 @@ module Line
             super
           end
 
-          def bubble(&)
-            @contents = Line::Message::Builder::Flex::Bubble.new(context: context, &)
+          def bubble(**options, &)
+            @contents = Line::Message::Builder::Flex::Bubble.new(context: context, **options, &)
           end
 
           def to_h

data/lib/line/message/builder/flex/button.rb

@@ -6,31 +6,41 @@ module Line
       module Flex
         # The button is a component of the Flex message.
         class Button < Line::Message::Builder::Base
+          include Actionable
+          include Position::Vertical
+          include Position::Padding
+          include Position::Margin
+          include Position::Offset
+
+          option :flex, default: nil
           option :style, default: :link
           option :height, default: :md
 
-          def initialize(context: nil, **options, &)
-            @action = nil
-
-            super
-          end
-
-          def message(text, label:, display_text: nil, &)
-            @action = Actions::Message.new(text: text, label: label, display_text: display_text, &)
-          end
-
-          def postback(data, label: nil, display_text: nil, &)
-            @action = Actions::Postback.new(data: data, label: label, display_text: display_text, &)
-          end
-
-          def to_h
-            raise Error, "Action is required" unless @action
+          def to_h # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+            raise RequiredError, "action is required" if action.nil?
 
             {
               type: "button",
-              action: @action.to_h,
-              style: @style,
-              height: @height
+              action: action.to_h,
+              # Position
+              grivity: gravity,
+              # Position::Padding
+              paddingAll: padding,
+              paddingTop: padding_top,
+              paddingBottom: padding_bottom,
+              paddingStart: padding_start,
+              paddingEnd: padding_end,
+              # Position::Margin
+              margin: margin,
+              # Position::Offset
+              position: position,
+              offsetTop: offset_top,
+              offsetBottom: offset_bottom,
+              offsetStart: offset_start,
+              offsetEnd: offset_end,
+              flex: flex,
+              style: style,
+              height: height
             }.compact
           end
         end

data/lib/line/message/builder/flex/image.rb

@@ -6,9 +6,18 @@ module Line
       module Flex
         # The image is a component for the Flex message.
         class Image < Line::Message::Builder::Base
+          include Actionable
+          include Position::Horizontal
+          include Position::Vertical
+          include Position::Margin
+          include Position::Offset
+
+          attr_reader :url
+
           option :size, default: nil
           option :aspect_ratio, default: nil
           option :aspect_mode, default: nil
+          option :flex, default: nil
 
           def initialize(url, context: nil, **options, &)
             @url = url
@@ -16,25 +25,28 @@ module Line
             super(context: context, **options, &)
           end
 
-          def size(size)
-            @size = size
-          end
-
-          def aspect_ratio(aspect_ratio)
-            @aspect_ratio = aspect_ratio
-          end
-
-          def aspect_mode(aspect_mode)
-            @aspect_mode = aspect_mode
-          end
+          def to_h # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+            raise RequiredError, "url is required" if url.nil?
 
-          def to_h
             {
               type: "image",
-              url: @url,
-              size: @size,
-              aspectRatio: @aspect_ratio,
-              aspectMode: @aspect_mode
+              url: url,
+              # Position
+              align: align,
+              gravity: gravity,
+              # Position::Margin
+              margin: margin,
+              # Position::Offset
+              position: position,
+              offsetTop: offset_top,
+              offsetBottom: offset_bottom,
+              offsetStart: offset_start,
+              offsetEnd: offset_end,
+              size: size,
+              flex: flex,
+              aspectRatio: aspect_ratio,
+              aspectMode: aspect_mode,
+              action: action&.to_h
             }.compact
           end
         end

data/lib/line/message/builder/flex/position.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Line
+  module Message
+    module Builder
+      module Flex
+        module Position
+          # The horizontal provides "align" options for flex components.
+          module Horizontal
+            def self.included(base)
+              base.option :align,
+                          default: :nil,
+                          validator: Validators::Enum.new(
+                            :start, :center, :end
+                          )
+            end
+          end
+
+          # The vertical provides "gatvity" options for flex components.
+          module Vertical
+            def self.included(base)
+              base.option :gravity,
+                          default: :nil,
+                          validator: Validators::Enum.new(
+                            :top, :center, :bottom
+                          )
+            end
+          end
+
+          # The padding provides "padding" options for flex components.
+          module Padding
+            def self.included(base)
+              %i[padding padding_top padding_bottom padding_start padding_end].each do |option|
+                base.option option,
+                            default: :nil,
+                            validator: Validators::PercentageSize.new
+              end
+            end
+          end
+
+          # The margin provides "margin" options for flex components.
+          module Margin
+            def self.included(base)
+              base.option :margin,
+                          default: :nil,
+                          validator: Validators::Size.new
+            end
+          end
+
+          # The offset provides "offset" options for flex components.
+          module Offset
+            def self.included(base)
+              base.option :position,
+                          default: :nil,
+                          validator: Validators::Enum.new(:absolute, :relative)
+
+              %i[offset_top offset_bottom offset_start offset_end].each do |option|
+                base.option option,
+                            default: :nil,
+                            validator: Validators::Size.new
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/line/message/builder/flex/text.rb

@@ -6,11 +6,18 @@ module Line
       module Flex
         # The text is a component of the Flex message.
         class Text < Line::Message::Builder::Base
+          include Actionable
+          include Position::Horizontal
+          include Position::Vertical
+          include Position::Margin
+          include Position::Offset
+
+          attr_reader :text
+
+          option :size, default: nil
           option :wrap, default: false
           option :line_spacing, default: nil
           option :color, default: nil
-          option :size, default: nil
-          option :align, default: nil
           option :flex, default: nil
 
           def initialize(text, context: nil, **options, &)
@@ -23,16 +30,29 @@ module Line
             @wrap = true
           end
 
-          def to_h
+          def to_h # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+            raise RequiredError, "text is required" if text.nil?
+
             {
               type: "text",
-              text: @text,
-              wrap: @wrap,
-              lineSpacing: @line_spacing,
-              color: @color,
-              size: @size,
-              align: @align,
-              flex: @flex
+              text: text,
+              # Position
+              align: align,
+              gravity: gravity,
+              # Position::Margin
+              margin: margin,
+              # Position::Offset
+              position: position,
+              offsetTop: offset_top,
+              offsetBottom: offset_bottom,
+              offsetStart: offset_start,
+              offsetEnd: offset_end,
+              wrap: wrap,
+              lineSpacing: line_spacing,
+              color: color,
+              size: size,
+              flex: flex,
+              action: action&.to_h
             }.compact
           end
         end

data/lib/line/message/builder/flex.rb

@@ -6,6 +6,8 @@ module Line
       # The Flex module allows to build Flex messages.
       module Flex
         require_relative "flex/builder"
+        require_relative "flex/actionable"
+        require_relative "flex/position"
 
         # Container
         require_relative "flex/bubble"

data/lib/line/message/builder/quick_reply.rb

@@ -13,14 +13,14 @@ module Line
 
         def message(text, label:, image_url: nil, &)
           action(
-            Actions::Message.new(text: text, label: label, &),
+            Actions::Message.new(text, label: label, &),
             image_url
           )
         end
 
         def postback(data, label: nil, display_text: nil, image_url: nil, &)
           action(
-            Actions::Postback.new(data: data, label: label, display_text: display_text, &),
+            Actions::Postback.new(data, label: label, display_text: display_text, &),
             image_url
           )
         end

data/lib/line/message/builder/text.rb

@@ -5,16 +5,19 @@ module Line
     module Builder
       # Text message builder.
       class Text < Base
-        def initialize(text, context: nil, &block)
+        option :quote_token, default: nil
+
+        def initialize(text, context: nil, **options, &block)
           @text = text
 
-          super(context: context, &block)
+          super(context: context, **options, &block)
         end
 
         def to_h
           {
             type: "text",
             text: @text,
+            quoteToken: quote_token,
             quickReply: @quick_reply&.to_h
           }.compact
         end

data/lib/line/message/builder/validators/enum.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Line
+  module Message
+    module Builder
+      module Validators
+        # Validate values against a set of allowed values.
+        class Enum
+          attr_reader :allowed_values
+
+          def initialize(*allowed_values)
+            @allowed_values = allowed_values
+          end
+
+          def valid!(value)
+            return if allowed_values.include?(value.to_sym)
+
+            raise ValidationError, "Invalid value: #{value}. Allowed values are: #{allowed_values.join(", ")}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/line/message/builder/validators/size.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Line
+  module Message
+    module Builder
+      module Validators
+        # Validate size values for LINE messages.
+        class Size
+          KEYWORDS = %i[none xs sm md lg xl xxl].freeze
+
+          def valid?(value)
+            is_keyword = KEYWORDS.include?(value.to_sym)
+            is_pixels = value.end_with?("px")
+            is_keyword || is_pixels
+          end
+
+          def valid!(value)
+            return if valid?(value)
+
+            raise ValidationError,
+                  "Invalid value: #{value}. Allowed values are: #{KEYWORDS.join(", ")} or a pixel value (e.g., '100px')"
+          end
+        end
+
+        # Validate size values with percentage.
+        class PercentageSize < Size
+          def valid!(value)
+            is_percentage = value.end_with?("%")
+            return if is_percentage || valid?(value)
+
+            raise ValidationError,
+                  "Invalid value: #{value}. Allowed values are: #{KEYWORDS.join(", ")}, " \
+                  "a pixel value (e.g., '100px'), or a percentage (e.g., '50%')"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/line/message/builder/validators.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Line
+  module Message
+    module Builder
+      # :nodoc:
+      module Validators
+        require_relative "validators/enum"
+        require_relative "validators/size"
+      end
+    end
+  end
+end

data/lib/line/message/builder/version.rb

@@ -3,7 +3,7 @@
 module Line
   module Message
     module Builder
-      VERSION = "0.3.0"
+      VERSION = "0.5.0"
     end
   end
 end

data/lib/line/message/builder.rb

@@ -7,8 +7,11 @@ module Line
     # The Builder module provides a DSL for building LINE messages.
     module Builder
       class Error < StandardError; end
+      class RequiredError < Error; end
+      class ValidationError < Error; end
 
       require_relative "builder/base"
+      require_relative "builder/validators"
       require_relative "builder/actions"
       require_relative "builder/quick_reply"
       require_relative "builder/container"

data/lib/line/message/rspec/matchers/have_flex_bubble.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Line
+  module Message
+    module RSpec
+      # :nodoc:
+      module Matchers
+        # The flex component matcher for RSpec to search nested flex components in the message array.
+        class HaveFlexBubble
+          def initialize(expected)
+            @expected = Utils.stringify_keys!(expected || {}, deep: true)
+          end
+
+          def description
+            return "have flex bubble" if @expected.empty?
+
+            "have flex bubble matching #{@expected.inspect}"
+          end
+
+          def matches?(actual)
+            @actual = Utils.stringify_keys!(actual, deep: true)
+            @actual.any? { |message| match_flex_component?(message) }
+          end
+          alias == matches?
+
+          def failure_message
+            return "expected to find a flex bubble" if @expected.empty?
+
+            "expected to find a flex bubble matching #{@expected.inspect}"
+          end
+
+          private
+
+          def match_flex_component?(message)
+            return false unless message["type"] == "flex"
+
+            match_content?(message["contents"])
+          end
+
+          def match_content?(content)
+            return match_options?(content) if content["type"] == "bubble"
+            return false unless content["contents"]
+
+            content["contents"].any? { |nested_content| match_content?(nested_content) }
+          end
+
+          def match_options?(content)
+            return false unless content["type"] == "bubble"
+
+            ::RSpec::Matchers::BuiltIn::Include.new(@expected).matches?(content)
+          end
+        end
+
+        def have_line_flex_bubble(expected = nil) # rubocop:disable Naming/PredicateName
+          HaveFlexBubble.new(expected)
+        end
+      end
+    end
+  end
+end

data/lib/line/message/rspec/matchers/have_text_message.rb

@@ -8,33 +8,37 @@ module Line
         # The text message matcher for RSpec to search for text messages in the message array.
         class HaveTextMessage
           def initialize(expected)
-            @expected = expected
+            @text, @options = expected
+            @options = Utils.stringify_keys!(@options || {})
           end
 
           def description
-            return "have text message" if @expected.nil?
+            return "have text message" if @text.nil?
+            return "have text message matching #{@text.inspect}" if @options.empty?
 
-            "have text message matching #{@expected.inspect}"
+            "have text message matching #{@text.inspect} with options #{@options.inspect}"
           end
 
           def matches?(actual)
             @actual = Utils.stringify_keys!(actual, deep: true)
-            @actual.each do |message|
+            @actual.any? do |message|
               next unless message["type"] == "text"
+              next true if @text.nil?
 
-              return true if message["text"].match?(@expected)
+              message["text"].match?(@text) && ::RSpec::Matchers::BuiltIn::Include.new(@options).matches?(message)
             end
-
-            false
           end
           alias == matches?
 
           def failure_message
-            "expected to find a text message matching #{@expected}"
+            return "expected to find a text message" if @text.nil?
+            return "expected to find a text message matching #{@text.inspect}" if @options.empty?
+
+            "expected to find a text message matching #{@text.inspect} with options #{@options.inspect}"
           end
         end
 
-        def have_line_text_message(expected = nil) # rubocop:disable Naming/PredicateName
+        def have_line_text_message(*expected) # rubocop:disable Naming/PredicateName
           HaveTextMessage.new(expected)
         end
       end

data/lib/line/message/rspec/matchers.rb

@@ -4,4 +4,5 @@ require_relative "matchers/utils"
 require_relative "matchers/have_text_message"
 require_relative "matchers/have_quick_reply"
 require_relative "matchers/have_flex_message"
+require_relative "matchers/have_flex_bubble"
 require_relative "matchers/have_flex_component"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: line-message-builder
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Aotokitsuruya
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-05 00:00:00.000000000 Z
+date: 2025-04-07 00:00:00.000000000 Z
 dependencies: []
 description: The LINE Messaging API message builder.
 email:
@@ -32,17 +32,23 @@ files:
 - lib/line/message/builder/base.rb
 - lib/line/message/builder/container.rb
 - lib/line/message/builder/flex.rb
+- lib/line/message/builder/flex/actionable.rb
 - lib/line/message/builder/flex/box.rb
 - lib/line/message/builder/flex/bubble.rb
 - lib/line/message/builder/flex/builder.rb
 - lib/line/message/builder/flex/button.rb
 - lib/line/message/builder/flex/image.rb
+- lib/line/message/builder/flex/position.rb
 - lib/line/message/builder/flex/text.rb
 - lib/line/message/builder/quick_reply.rb
 - lib/line/message/builder/text.rb
+- lib/line/message/builder/validators.rb
+- lib/line/message/builder/validators/enum.rb
+- lib/line/message/builder/validators/size.rb
 - lib/line/message/builder/version.rb
 - lib/line/message/rspec.rb
 - lib/line/message/rspec/matchers.rb
+- lib/line/message/rspec/matchers/have_flex_bubble.rb
 - lib/line/message/rspec/matchers/have_flex_component.rb
 - lib/line/message/rspec/matchers/have_flex_message.rb
 - lib/line/message/rspec/matchers/have_quick_reply.rb