mobile_workflow 0.7.4 → 0.7.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 793d6e2517f66a2a0eb664541c4b97a37b5bb8c3a6e55e007b8d0c9947e7dbfc
-  data.tar.gz: 12288b78b8f962f7b99ac47f7f3eaaf8c3390a474672ee943f5ac86123e47f0d
+  metadata.gz: 652ebd5ca3b96f993ee3c6a7bc57863eaa70119fb41aca0586a02430795bd0d1
+  data.tar.gz: ab8191098d6eeed1825fd8fd1a2debb5c4ae762cfb887362793e96a7d62278ae
 SHA512:
-  metadata.gz: f9a5594c34e7dfbfd71dd239aca140018fe9fef0ffcf55b356000450b9e84e9615457c62edc43fe33ebd67b2d3665b02c15ff893079a2e76b387c9811a60bfa9
-  data.tar.gz: 7925c77c229f26fd42b8639038ff74b4f89fa6bfe1a1c7662309f8ae4dce1ca27046bb60e9e5640f5e6360a6b30c2ec666a801048e731213576ab08d3b78d21d
+  metadata.gz: 4b4acc6286656e349602808ac82b6049da2e8ef3d721fba490346d0f003701c9efdde26fdcf9b2352df2ff3bc34d40bec571f941701129298baa02d8f356ad29
+  data.tar.gz: 7a1cfa5d993b5bfc91f98ede6e6c7000990ffd149bafe18c0f4232e80462a7fd9d0cea0eec2c020437e6cdb3dce7a14e747e4b4dfe6e4cd6886b4b28fc0905f3

data/README.md

@@ -26,6 +26,89 @@ Or install it yourself as:
 $ gem install mobile_workflow
 ```
 
+## Upgrade to version 0.7.7 or higher
+The following utility methods have changed their parameters:
+
+```ruby
+# app/models/concerns/mobile_workflow/displayable/steps/styled_content/grid.rb#20
+def mw_grid_item(id: self.id, text:, detail_text: nil, preview_url: nil)
+  raise 'Missing id' if id.nil?
+  raise 'Missing text' if text.nil?
+  
+  { id: id, text: text, type: :item, detailText: detail_text, imageURL: preview_url }.compact
+end
+
+# app/models/concerns/mobile_workflow/displayable/steps/styled_content/stack.rb#20
+def mw_stack_list_item(id:, text:, detail_text: nil, preview_url: nil)
+  raise 'Missing id' if id.nil?
+  raise 'Missing text' if text.nil?
+
+  { id: id.to_s, text: text, detailText: detail_text, type: :listItem, imageURL: preview_url }.compact
+end
+
+# app/models/concerns/mobile_workflow/displayable/steps/list.rb#5
+def mw_list_item(id: self.id, text:, detail_text: nil, sf_symbol_name: nil, material_icon_name: nil, preview_url: nil)
+  { id: id, text: text, detailText: detail_text, sfSymbolName: sf_symbol_name, materialIconName: material_icon_name, imageURL: preview_url }.compact
+end
+
+# app/models/concerns/mobile_workflow/displayable/steps/stack.rb#26
+def mw_display_video(preview_url:, attachment_url:)
+  {type: :video, previewURL: preview_url, url: attachment_url}
+end
+
+# app/models/concerns/mobile_workflow/displayable/steps/stack.rb#11
+def mw_display_image(preview_url:, attachment_url:, content_mode: :scale_aspect_fill)
+  validate_content_mode!(content_mode)
+  
+  {type: :image, contentMode: camelcase_converter(content_mode.to_s, first_letter: :lower), previewURL: preview_url, url: attachment_url}
+end
+```
+
+All URLs MUST now be explicitly sent as arguments to the above methods, which means they must be previously set. If not, the methods will not work.
+
+In order to support projects using `ActiveStorage`, there is a new model concern `MobileWorkflow::Attachable` that provides a few helpers. This is what you can do to upgrade if you use ActiveStorage (otherwise the helpers must be manually created):
+
+1. Include the concern in the `ApplicationRecord` class, together with `MobileWorkflow::Displayable`:
+
+```ruby
+class ApplicationRecord < ActiveRecord::Base
+  include MobileWorkflow::Attachable
+  include MobileWorkflow::Displayable
+end
+```
+
+2. Once included, the following helpers will be available, so use them to generate the intended URLs:
+
+```ruby
+def preview_url(attachment, options: { resize_to_fill: [200, 200] })
+  return nil unless attachment.attached?
+
+  if attachment.image?
+    rails_representation_url(attachment.variant(options), host: heroku_attachment_host)
+  elsif attachment.previewable?
+    rails_representation_url(attachment.preview(options), host: heroku_attachment_host)
+  else
+    return nil
+  end
+end
+
+def attachment_url(attachment)
+  return nil unless attachment.attached?
+
+  rails_blob_url(attachment, host: heroku_attachment_host)
+end
+```
+
+Example of use:
+```ruby
+# Old method call
+mw_list_item(text: 'John Doe', detail_text: 'Company Name', image_attachment: <ActiveStorage::Attached::One>, image_url: 'https://test.org/preview')
+
+# New method call
+preview_url = preview_url(<ActiveStorage::Attached::One>, options: { resize_to_fill: [200, 200] }) || 'https://test.org/preview'
+mw_list_item(text: 'John Doe', detail_text: 'Company Name', preview_url: preview_url)
+```
+
 ## Contributing
 Contribution directions go here.
 

data/app/controllers/concerns/mobile_workflow/s3_storable.rb

@@ -1,19 +1,23 @@
+require 'aws-sdk-s3'
+
 module MobileWorkflow
   module S3Storable
     if Object.const_defined?("Aws::S3")
       extend ActiveSupport::Concern
       
       def binary_urls(object)
-        return unless params["binaries"]
+        return unless params[:binaries]
     
-        params["binaries"].map do |binary|
-          object_attribute = binary["identifier"]
-          extension = binary["mimetype"].split('/')[1] # i.e. image/jpg --> jpg, video/mp4 --> mp4
-      
+        params[:binaries].map do |binary|
+          identifier = binary[:identifier]
+          object_attribute = identifier.split(".")[0] # ensure extension doesnt get added here
+          extension = binary[:mimetype].split('/')[1] # i.e. image/jpg --> jpg, video/mp4 --> mp4
+          metadata = binary[:metadata]
+
           {
-            "identifier" => binary["identifier"],
-            "url" => presigned_url("#{object.class.name.underscore}/#{object.id}/#{object_attribute}/#{s3_object_uuid}.#{extension}"),
-            "method" => "PUT"
+            identifier: identifier,
+            url: presigned_url("#{object.class.name.underscore}/#{object.id}/#{object_attribute}/#{s3_object_uuid}.#{extension}", metadata: metadata),
+            method: "PUT"
           }
         end
       end
@@ -23,8 +27,8 @@ module MobileWorkflow
         SecureRandom.uuid
       end
       
-      def presigned_url(key)
-        presigner.presigned_url(:put_object, bucket: ENV['AWS_BUCKET_NAME'], key: key, metadata: {})
+      def presigned_url(key, metadata: nil)
+        presigner.presigned_url(:put_object, bucket: ENV['AWS_BUCKET_NAME'], key: key, metadata: metadata)
       end
   
       def presigner
@@ -34,7 +38,6 @@ module MobileWorkflow
       def s3_client
         Aws::S3::Client.new(region: ENV['AWS_REGION'], access_key_id: ENV['AWS_ACCESS_ID'], secret_access_key: ENV['AWS_SECRET_KEY'])
       end
-      
     end
   end
 end

data/app/controllers/mobile_workflow/sns_notifications_controller.rb

@@ -1,3 +1,5 @@
+require 'aws-sdk-sns'
+
 module MobileWorkflow
   class SnsNotificationsController < ActionController::API
     if Object.const_defined?("Aws::S3") && Object.const_defined?("Aws::SNS")
@@ -10,26 +12,16 @@ module MobileWorkflow
         when 'SubscriptionConfirmation'
           confirm_subscription ? (head :ok) : (head :bad_request)
         else
-          add_attachment
+          AddAttachmentJob.perform_now(object, object_key, attribute_name)
+          head :ok
         end
+      rescue NameError => e
+        Rails.logger.warn "Error attaching object: #{e.message}"
+      rescue ActiveRecord::RecordNotFound
+        head :not_found
       end
  
       private
-      def add_attachment
-        begin
-          @object = find_object
-          @object.send("#{attribute_name}=",active_record_blob)
-          if @object.save
-            head :ok
-          else
-            Rails.logger.warn "Error saving object: #{@object} #{object.errors.full_messages}"
-            head :unprocessable_entity
-          end
-        rescue NameError => e
-          Rails.logger.warn "Error attaching object: #{e.message}"
-          head :unprocessable_entity
-        end
-      end
        
       def verify_request_authenticity
         head :unauthorized if raw_post.blank?
@@ -37,22 +29,11 @@ module MobileWorkflow
         #head :unauthorized if raw_post.blank? || !message_verifier.authentic?(raw_post) # Not working
       end
   
-      def active_record_blob
-        s3_object = s3_bucket.object(object_key)
-        checksum_base64 = checksum_base64(object_key, s3_object)
-        ActiveStorage::Blob.create! key: s3_object.key, filename: s3_object.key, byte_size: s3_object.size, checksum: checksum_base64, content_type: s3_object.content_type
-      end
-  
-      def checksum_base64(object_key, s3_object)
-        path = Tempfile.new(object_key).path
-        s3_object.download_file(path)
-        file = File.new(path)
-        Digest::MD5.file(file).base64digest
-      end
-  
-      def find_object
-        object_class_name, object_id = key_identifiers
-        object_class_name.camelcase.constantize.find(object_id.to_i)
+      def object
+        @object ||= begin
+          object_class_name, object_id = key_identifiers
+          object_class_name.camelcase.constantize.find(object_id.to_i)
+        end
       end
   
       def attribute_name
@@ -91,11 +72,7 @@ module MobileWorkflow
         Rails.logger.warn(e.message)
         return false
       end
-  
-      def s3_bucket
-        Aws::S3::Resource.new(region: ENV['AWS_REGION'], access_key_id: ENV['AWS_ACCESS_ID'], secret_access_key: ENV['AWS_SECRET_KEY']).bucket(ENV['AWS_BUCKET_NAME'])
-      end
-  
+
       def sns_client
         Aws::SNS::Client.new(region: ENV['AWS_REGION'], access_key_id: ENV['AWS_ACCESS_ID'], secret_access_key: ENV['AWS_SECRET_KEY'])
       end

data/app/jobs/mobile_workflow/add_attachment_job.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module MobileWorkflow
+  class AddAttachmentJob < ApplicationJob
+    def perform(object, object_key, attribute_name)
+      object.send("#{attribute_name}=", active_record_blob_from_s3(object_key))
+      Rails.logger.warn "Error saving object: #{object} #{object.errors.full_messages}" unless object.save
+    rescue NoMethodError => e
+      Rails.logger.warn "Error attaching object: #{e.message}"
+    end
+
+    private
+
+    def active_record_blob_from_s3(object_key)
+      # etag cannot be used as the MD5 checksum when doing multi-part uploads
+      s3_object = s3_bucket.object(object_key)
+      base64_digest = hex_to_base64_digest(s3_object.etag.delete('"'))
+      ActiveStorage::Blob.create! key: s3_object.key, filename: s3_object.key, byte_size: s3_object.size,
+                                  checksum: base64_digest, content_type: s3_object.content_type
+    end
+
+    def s3_bucket
+      Aws::S3::Resource.new(region: ENV['AWS_REGION'], access_key_id: ENV['AWS_ACCESS_ID'], secret_access_key: ENV['AWS_SECRET_KEY']).bucket(ENV['AWS_BUCKET_NAME'])
+    end
+
+    def hex_to_base64_digest(hexdigest)
+      [[hexdigest].pack('H*')].pack('m0')
+    end
+  end
+end

data/app/models/concerns/mobile_workflow/attachable.rb

@@ -0,0 +1,32 @@
+module MobileWorkflow
+  module Attachable
+    extend ActiveSupport::Concern
+    include Rails.application.routes.url_helpers
+
+    def preview_url(attachment, options: { resize_to_fill: [200, 200] })
+      return nil unless attachment.attached?
+
+      if attachment.image?
+        rails_representation_url(attachment.variant(options), host: heroku_attachment_host)
+      elsif attachment.previewable?
+        rails_representation_url(attachment.preview(options), host: heroku_attachment_host)
+      else
+        return nil
+      end
+    end
+
+    def attachment_url(attachment)
+      return nil unless attachment.attached?
+    
+      rails_blob_url(attachment, host: heroku_attachment_host)
+    end
+
+    private
+
+    def heroku_attachment_host
+      # TODO: MBS - move this to a configuration property
+      app_name = Rails.env.test? ? 'test-app' : ENV.fetch('HEROKU_APP_NAME')
+      "https://#{app_name}.herokuapp.com"
+    end
+  end
+end

data/app/models/concerns/mobile_workflow/displayable/steps/form.rb

@@ -0,0 +1,70 @@
+module MobileWorkflow
+  module Displayable
+    module Steps
+      module Form
+        def mw_form_section(label:, identifier:)
+          raise 'Missing label' if label.nil?
+          raise 'Missing identifier' if identifier.nil?
+    
+          { item_type: :section, label: label, identifier: identifier }
+        end
+    
+        def mw_form_multiple_selection(label:, identifier:, multiple_selection_options:, selection_type: :single, optional: false, show_other_option: false)
+          raise 'Missing label' if label.nil?
+          raise 'Missing identifier' if identifier.nil?
+          raise 'Missing multiple selection options' if multiple_selection_options.nil?
+    
+          { item_type: :multiple_selection, label: label, identifier: identifier, multiple_selection_options: multiple_selection_options, selection_type: selection_type, optional: optional, show_other_option: show_other_option }
+        end
+    
+        def mw_form_multiple_selection_options(text:, hint: nil, is_pre_selected: false)
+          raise 'Missing text' if text.nil?
+    
+          { text: text, hint: hint, isPreSelected: is_pre_selected }
+        end
+    
+        def mw_form_number(label:, identifier:, placeholder: nil, optional: false, symbol_position: :leading, default_text_answer: nil, hint: nil)
+          raise 'Missing label' if label.nil?
+          raise 'Missing identifier' if identifier.nil?
+    
+          { item_type: :number, number_type: :number, label: label, identifier: identifier, placeholder: placeholder, optional: optional, symbol_position: symbol_position, default_text_answer: default_text_answer, hint: hint }
+        end
+    
+        def mw_form_text(label:, identifier:, placeholder: nil, optional: false, multiline: false, default_text_answer: nil)
+          raise 'Missing label' if label.nil?
+          raise 'Missing identifier' if identifier.nil?
+    
+          { item_type: :text, label: label, identifier: identifier, placeholder: placeholder, optional: optional, multiline: multiline, default_text_answer: default_text_answer }
+        end
+    
+        def mw_form_date(label:, identifier:, optional: false, default_text_answer: nil)
+          raise 'Missing label' if label.nil?
+          raise 'Missing identifier' if identifier.nil?
+    
+          { item_type: :date, date_type: :calendar, label: label, identifier: identifier, optional: optional, default_text_answer: default_text_answer }
+        end
+    
+        def mw_form_time(label:, identifier:, optional: false, default_text_answer: nil)
+          raise 'Missing label' if label.nil?
+          raise 'Missing identifier' if identifier.nil?
+    
+          { item_type: :time, label: label, identifier: identifier, optional: optional, default_text_answer: default_text_answer }
+        end
+    
+        def mw_form_email(label:, identifier:, placeholder: nil, optional: false, default_text_answer: nil)
+          raise 'Missing label' if label.nil?
+          raise 'Missing identifier' if identifier.nil?
+    
+          { item_type: :email, label: label, identifier: identifier, placeholder: placeholder, optional: optional, default_text_answer: default_text_answer }
+        end
+    
+        def mw_form_password(label:, identifier:, placeholder: nil, optional: false, default_text_answer: nil, hint: nil)
+          raise 'Missing label' if label.nil?
+          raise 'Missing identifier' if identifier.nil?
+    
+          { item_type: :secure, label: label, identifier: identifier, placeholder: placeholder, optional: optional, default_text_answer: default_text_answer, hint: hint }
+        end
+      end
+    end
+  end
+end

data/app/models/concerns/mobile_workflow/displayable/steps/list.rb

@@ -0,0 +1,15 @@
+module MobileWorkflow
+  module Displayable
+    module Steps
+      module List
+        def mw_list_item(id: self.id, text:, detail_text: nil, sf_symbol_name: nil, material_icon_name: nil, preview_url: nil)
+          { id: id, text: text, detailText: detail_text, sfSymbolName: sf_symbol_name, materialIconName: material_icon_name, imageURL: preview_url }.compact
+        end
+        
+        def mw_list_search_suggestion(id: self.id, text:, section_name:, sf_symbol_name: nil)
+          {id: id.to_s, text: text, sectionName: section_name, sfSymbolName: sf_symbol_name}.compact
+        end
+      end
+    end
+  end
+end

data/app/models/concerns/mobile_workflow/displayable/steps/map.rb

@@ -0,0 +1,11 @@
+module MobileWorkflow
+  module Displayable
+    module Steps
+      module Map
+        def mw_map_item(id: self.id, text:, detail_text: nil, latitude:, longitude:)
+          {id: id.to_s, text: text, detailText: detail_text, latitude: latitude, longitude: longitude}.compact
+        end
+      end
+    end
+  end
+end

data/app/models/concerns/mobile_workflow/displayable/steps/pie_chart.rb

@@ -0,0 +1,11 @@
+module MobileWorkflow
+  module Displayable
+    module Steps
+      module PieChart
+        def mw_pie_chart_item(id: self.id, label:, value:)
+          {id: id, label: label, value: value}.compact
+        end
+      end
+    end
+  end
+end

data/app/models/concerns/mobile_workflow/displayable/steps/question.rb

@@ -0,0 +1,25 @@
+module MobileWorkflow
+  module Displayable
+    module Steps
+      module Question
+        QUESTION_STYLES = [:single_choice, :multiple_choice]
+        
+        def mw_text_choice_question(question:, style:, text_choices:)
+          raise 'Missing question' if question.empty?
+          raise 'Text Choices should be a hash' unless text_choices.is_a?(Hash)
+
+          validate_question_style!(style)
+          
+          text_choices_a = text_choices.map{|k, v| {_class: "ORKTextChoice", exclusive: false, text: k, value: v} }.to_a
+          { question: question, answerFormat: { _class: "ORKTextChoiceAnswerFormat", style: camelcase_converter(style.to_s, first_letter: :lower), textChoices: text_choices_a}}
+        end
+
+        private
+        
+        def validate_question_style!(style)
+          raise 'Unknown style' unless QUESTION_STYLES.include?(style)      
+        end
+      end
+    end
+  end
+end

data/app/models/concerns/mobile_workflow/displayable/steps/stack.rb

@@ -0,0 +1,75 @@
+module MobileWorkflow
+  module Displayable
+    module Steps
+      module Stack
+        CONTENT_MODE_OPTIONS = [:scale_aspect_fill, :scale_aspect_fit] 
+
+        def mw_display_text(text:, label: nil)
+          {type: :text, label: label, text: text.to_s}.compact
+        end
+      
+        def mw_display_image(preview_url:, attachment_url:, content_mode: :scale_aspect_fill)
+          validate_content_mode!(content_mode)
+          
+          {type: :image, contentMode: camelcase_converter(content_mode.to_s, first_letter: :lower), previewURL: preview_url, url: attachment_url}
+        end
+        
+        def mw_display_unsplash_image(image_url)
+          if image_url.start_with? "https://unsplash.com/photos"
+            unsplash_id = image_url.split('/').last
+            image_url = "https://source.unsplash.com/#{unsplash_id}/800x600"
+          end
+          
+          {type: :image, previewURL: image_url, url: image_url}.compact
+        end
+        
+        def mw_display_video(preview_url:, attachment_url:)
+          {type: :video, previewURL: preview_url, url: attachment_url}
+        end
+      
+        def mw_display_button(label:, style: :primary, on_success: :forward, sf_symbol_name: nil, material_icon_name: nil)
+          validate_on_success!(on_success)
+          validate_button_style!(style)
+          
+          {type: :button, label: label, style: style, onSuccess: on_success, sfSymbolName: sf_symbol_name, materialIconName: material_icon_name}.compact
+        end
+      
+        def mw_display_delete_button(url:, label: "Delete", method: :delete, style: :danger, on_success: :backward)
+          validate_on_success!(on_success)
+          validate_button_style!(style)
+          
+          {type: :button, label: label, url: url, method: method, style: style, onSuccess: on_success, sfSymbolName: 'trash', materialIconName: 'delete'}.compact
+        end
+            
+        def mw_display_url_button(url:, label:, method: :put, style: :primary, confirm_title: nil, confirm_text: nil, on_success: :reload, sf_symbol_name: nil, material_icon_name: nil)
+          validate_on_success!(on_success)
+          validate_button_style!(style)
+          
+          {type: :button, label: label, url: url, method: method, style: style, confirmTitle: confirm_title, confirmText: confirm_text, onSuccess: on_success, sfSymbolName: sf_symbol_name, materialIconName: material_icon_name}.compact
+        end
+        alias_method :mw_display_button_for_url, :mw_display_url_button
+        
+        def mw_display_system_url_button(label:, apple_system_url: nil, android_deep_link: nil, style: :primary, sf_symbol_name: nil, material_icon_name: nil)
+          validate_button_style!(style)
+          raise 'Invalid android_deep_link' if android_deep_link && !android_deep_link.start_with?('http')
+          
+          {type: :button, label: label, appleSystemURL: apple_system_url, androidDeepLink: android_deep_link, style: style, sfSymbolName: sf_symbol_name, materialIconName: material_icon_name}.compact
+        end
+        alias_method :mw_display_button_for_system_url, :mw_display_system_url_button
+        
+        def mw_display_modal_workflow_button(label:, modal_workflow_name:, style: :primary, on_success: :none, sf_symbol_name: nil, material_icon_name: nil)
+          validate_on_success!(on_success)
+          validate_button_style!(style)
+          
+          {type: :button, label: label, modalWorkflow: modal_workflow_name, style: style, onSuccess: on_success, sfSymbolName: sf_symbol_name, materialIconName: material_icon_name}.compact
+        end
+        alias_method :mw_display_button_for_modal_workflow, :mw_display_modal_workflow_button
+
+        private
+        def validate_content_mode!(on_success)
+          raise 'Unknown content_mode' unless CONTENT_MODE_OPTIONS.include?(on_success)
+        end
+      end
+    end
+  end
+end

data/app/models/concerns/mobile_workflow/displayable/steps/styled_content/grid.rb

@@ -0,0 +1,30 @@
+module MobileWorkflow
+  module Displayable
+    module Steps
+      module StyledContent
+        module Grid
+          def mw_grid_large_section(id:, text:)
+            raise 'Missing id' if id.nil?
+            raise 'Missing text' if text.nil?
+            
+            { id: id, text: text, type: :largeSection }
+          end
+          
+          def mw_grid_small_section(id:, text:)
+            raise 'Missing id' if id.nil?
+            raise 'Missing text' if text.nil?
+            
+            { id: id, text: text, type: :smallSection }
+          end
+          
+          def mw_grid_item(id: self.id, text:, detail_text: nil, preview_url: nil)
+            raise 'Missing id' if id.nil?
+            raise 'Missing text' if text.nil?
+            
+            { id: id, text: text, type: :item, detailText: detail_text, imageURL: preview_url }.compact
+          end
+        end
+      end
+    end
+  end
+end

data/app/models/concerns/mobile_workflow/displayable/steps/styled_content/stack.rb

@@ -0,0 +1,40 @@
+module MobileWorkflow
+  module Displayable
+    module Steps
+      module StyledContent
+        module Stack
+          def mw_stack_title(id:, title:)
+            raise 'Missing id' if id.nil?
+            raise 'Missing title' if title.nil?
+        
+            { id: id, title: title, type: :title }
+          end
+        
+          def mw_stack_text(id:, text:)
+            raise 'Missing id' if id.nil?
+            raise 'Missing text' if text.nil?
+        
+            { id: id, text: text, type: :text }
+          end
+        
+          def mw_stack_list_item(id:, text:, detail_text: nil, preview_url: nil)
+            raise 'Missing id' if id.nil?
+            raise 'Missing text' if text.nil?
+        
+            { id: id.to_s, text: text, detailText: detail_text, type: :listItem, imageURL: preview_url }.compact
+          end
+        
+          def mw_stack_button(id:, label:, url: nil, method: :nil, on_success: :none, style: :primary, modal_workflow_name: nil, link_url: nil, sf_symbol_name: nil, apple_system_url: nil, android_deep_link: nil, confirm_title: nil, confirm_text: nil)
+            raise 'Missing id' if id.nil?
+            raise 'Missing label' if label.nil?
+        
+            validate_on_success!(on_success)
+            validate_button_style!(style)
+        
+            { id: id, type: :button, label: label, url: url, method: method, onSuccess: on_success, style: style, modalWorkflow: modal_workflow_name, linkURL: link_url, sfSymbolName: sf_symbol_name, appleSystemURL: apple_system_url, androidDeepLink: android_deep_link, confirmTitle: confirm_title, confirmText: confirm_text }.compact
+          end
+        end
+      end
+    end
+  end
+end