line-message-builder 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa7a2c0c112ef20086d81a2c1cf4b1c430ffe291c07ccfc92dfe8d81db1ea980
-  data.tar.gz: 163eb284640eeec1e5a035492ebca95b34d703d372f5d472e4330a762d7b2ceb
+  metadata.gz: 3bbeb0eeec944a0886b6e6dec3b171c88182c0097ad31c03cc16d7270f1eb471
+  data.tar.gz: 8f08afeab2e40b152e8e4218b00f03f725be5f3cfa70b687ebaf20e7d1dd2d7e
 SHA512:
-  metadata.gz: bcadb195ad72f851fcc648f6641ab547fc2a1885583f64be97f08288f43025246d2a14dd311103a5c64521e636dfb2bd0f89f61deccedec75ebe8bebdc528d2c
-  data.tar.gz: 1d612904e46b6e3e87590edf414b7839fa18412fe1c4734cdb961aacc8c1ed2e87a87a425b3cf563cc1eff4ec7337deaf0ff81592b75520dabba78363ec67629
+  metadata.gz: 0afd2ab03e4bbe7df364ebc27764380e48b9fd00a0a78ba345655f9227b7ff1cac00831024fd4ca923d2df1fb195c7e3c4947e6290f530a3466d002b325af4f3
+  data.tar.gz: 91455d81ccc9d6aa646e5a5851ad55baa19e89d4c427b4c9e4fa951676f6cf5d6e8005983d5a76610c05ced666a353d06f54ef7020516ad67250000cb4379ba7

data/.release-please-manifest.json

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

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [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

@@ -95,6 +95,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 +155,7 @@ end
 
 | Type     | Supported |
 | ----     | --------- |
-| Text     | ✅        |
+| Text     | 🚧        |
 | Text v2  | ❌        |
 | Sticker  | ❌        |
 | Sticker  | ❌        |
@@ -189,19 +190,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,7 +6,7 @@ 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, &)
+          def initialize(text, label: nil, context: nil, &)
             @text = text
             @label = label
 

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

@@ -6,7 +6,7 @@ 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, &)
+          def initialize(data, label: nil, display_text: nil, context: nil, &)
             @data = data
             @label = label
             @display_text = display_text

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/box.rb

@@ -6,7 +6,11 @@ module Line
       module Flex
         # The box is a component for the Flex message.
         class Box < Line::Message::Builder::Base
+          attr_reader :contents
+
           option :layout, default: :horizontal
+          option :spacing, default: nil
+          option :flex, default: nil
 
           def initialize(context: nil, **options, &)
             @contents = []
@@ -31,10 +35,15 @@ module Line
           end
 
           def to_h
+            raise RequiredError, "layout is required" if layout.nil?
+            raise RequiredError, "contents is required" if contents.empty?
+
             {
               type: "box",
-              layout: @layout,
-              contents: @contents.map(&:to_h)
+              layout: layout,
+              spacing: spacing,
+              flex: flex,
+              contents: contents.map(&: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,6 +6,10 @@ module Line
       module Flex
         # The button is a component of the Flex message.
         class Button < Line::Message::Builder::Base
+          attr_reader :action
+
+          option :flex, default: nil
+          option :margin, default: nil
           option :style, default: :link
           option :height, default: :md
 
@@ -16,21 +20,23 @@ module Line
           end
 
           def message(text, label:, display_text: nil, &)
-            @action = Actions::Message.new(text: text, label: label, display_text: display_text, &)
+            @action = Actions::Message.new(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, &)
+            @action = Actions::Postback.new(data, label: label, display_text: display_text, &)
           end
 
           def to_h
-            raise Error, "Action is required" unless @action
+            raise RequiredError, "action is required" if action.nil?
 
             {
               type: "button",
-              action: @action.to_h,
-              style: @style,
-              height: @height
+              action: action.to_h,
+              flex: flex,
+              margin: margin,
+              style: style,
+              height: height
             }.compact
           end
         end

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

@@ -6,9 +6,14 @@ module Line
       module Flex
         # The image is a component for the Flex message.
         class Image < Line::Message::Builder::Base
+          attr_reader :url
+
           option :size, default: nil
           option :aspect_ratio, default: nil
           option :aspect_mode, default: nil
+          option :flex, default: nil
+          option :margin, default: nil
+          option :align, default: nil
 
           def initialize(url, context: nil, **options, &)
             @url = url
@@ -16,25 +21,18 @@ 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
+            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,
+              size: size,
+              flex: flex,
+              margin: margin,
+              align: align,
+              aspectRatio: aspect_ratio,
+              aspectMode: aspect_mode
             }.compact
           end
         end

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

@@ -6,12 +6,15 @@ module Line
       module Flex
         # The text is a component of the Flex message.
         class Text < Line::Message::Builder::Base
+          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
+          option :margin, default: nil
 
           def initialize(text, context: nil, **options, &)
             @text = text
@@ -23,16 +26,19 @@ module Line
             @wrap = true
           end
 
-          def to_h
+          def to_h # rubocop:disable Metrics/MethodLength
+            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,
+              wrap: wrap,
+              lineSpacing: line_spacing,
+              color: color,
+              size: size,
+              align: align,
+              margin: margin,
+              flex: flex
             }.compact
           end
         end

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/version.rb

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

data/lib/line/message/builder.rb

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

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.4.0
 platform: ruby
 authors:
 - Aotokitsuruya
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-05 00:00:00.000000000 Z
+date: 2025-04-06 00:00:00.000000000 Z
 dependencies: []
 description: The LINE Messaging API message builder.
 email:
@@ -43,6 +43,7 @@ files:
 - 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