slack_valid_block_kit 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '0480d87bdb716159283ac0c8293786bcc7049ae0359688051f7012c1d777987d'
+  data.tar.gz: c347150c2d148e79246849e997075746f84a2d841bce59d3fd5f045a3c31cc56
+SHA512:
+  metadata.gz: ff0d1441182f2ca00c9d6baa1e0652bdc4c12be126c6f6586bccc46cb91f8245b92e6f6b63319877e50352b65fc0ed40be4ac3fdf043de363cc5ffbeb733a504
+  data.tar.gz: 722d5e4da93846cda12e90d7a21c265b9485d66c94ca602f50054b1061baf45c8d1dbcd99ca2637aec4199d90de7821f65e85566402f0ca6e0e46797c6513040

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.6.8
+before_install: gem install bundler -v 1.17.2

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at masayuki-ioki@cookpad.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in slack_valid_block_kit.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 masayuki-ioki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,171 @@
+# SlackValidBlockKit
+
+A tool for building Slack Block Kit with validation.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'slack_valid_block_kit'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install slack_valid_block_kit
+
+## Usage
+
+- [surfaces.rb](https://github.com/kikaineko/slack_valid_block_kit/blob/main/lib/slack_valid_block_kit/builder/surfaces.rb) contains the [View objects](https://api.slack.com/reference/surfaces/views)
+- [layouts.rb](https://github.com/kikaineko/slack_valid_block_kit/blob/main/lib/slack_valid_block_kit/builder/layouts.rb) contains the [Layout blocks](https://api.slack.com/reference/messaging/blocks)
+- [elements.rb](https://github.com/kikaineko/slack_valid_block_kit/blob/main/lib/slack_valid_block_kit/builder/elements.rb) contains the [Block elements](https://api.slack.com/reference/messaging/block-elements)
+- [compositions.rb](https://github.com/kikaineko/slack_valid_block_kit/blob/main/lib/slack_valid_block_kit/builder/compositions.rb) contains the [Message composition objects](https://api.slack.com/reference/messaging/composition-objects)
+
+
+You can build views by `SlackValidBlockKit.build` or `SlackValidBlockKit.blocks`.
+
+Both methods run validation your views automatically.
+
+```ruby
+# Build modal with validation
+modal = SlackValidBlockKit.build do |b|
+  b.modal(...)
+end
+
+# Build blocks with validation
+blocks = SlackValidBlockKit.blocks do |b|
+  [...]
+end
+```
+
+If you want to skip validations, you write as follows.
+
+```ruby
+# Build modal without validation
+modal = SlackValidBlockKit.build(validate: false) do |b|
+  b.modal(...)
+end
+
+# Build blocks without validation
+blocks = SlackValidBlockKit.blocks(validate: false) do |b|
+  [...]
+end
+```
+
+or you can set to skip validations as config
+```ruby
+SlackValidBlockKit::Config.skip_validation = true
+```
+
+For example, when you ride on Rails, you can set in `config/initializers/slack_valid_block_kit.rb`.
+
+```ruby
+SlackValidBlockKit::Config.skip_validation = Rails.env.production?
+```
+
+You can just use validations.
+
+```ruby
+modal = ... # create a modal hash without SlackValidBlockKit
+
+SlackValidBlockKit.validate!(modal) # raise an exception with the invalid input
+
+
+blocks = ... # create a blocks array without SlackValidBlockKit
+
+SlackValidBlockKit.validate_blocks!(blocks) # raise an exception with the invalid input
+```
+
+## Examples
+
+Modal example with validation
+
+```ruby
+require 'slack_valid_block_kit'
+require 'json'
+
+modal = SlackValidBlockKit.build do |b|
+  b.modal(
+    title: b.plain_text(text: "Modal title"),
+    blocks: [
+      b.section(
+        text: b.mrkdwn(text: "It's Block Kit...but _in a modal_"),
+        block_id: "section1",
+        accessory: b.button(
+          text: b.plain_text(text: "Click me"),
+          action_id: "button_abc",
+          value: "Button value",
+          style: "danger"
+        )
+      )
+    ],
+    close: b.plain_text(text: "Cancel"),
+    submit: b.plain_text(text: "Save"),
+    private_metadata: "Shhhhhhhh",
+    callback_id: "view_identifier_12"
+  )
+end
+
+puts modal.to_json
+```
+
+You will get this.
+![modal example](https://user-images.githubusercontent.com/724270/167277875-c1e6627f-e59d-485f-b574-d5797c954f36.png)
+
+You can get a just `blocks` array (with validation).
+
+```ruby
+require 'slack_valid_block_kit'
+require 'json'
+
+blocks = SlackValidBlockKit.blocks do |b|
+  [
+    b.divider,
+    b.section(
+      text: b.mrkdwn(text: "*<fakeLink.toHotelPage.com|Windsor Court Hotel>*\n★★★★★\n$340 per night\nRated: 9.4 - Excellent"),
+      accessory: b.image(
+        image_url: "https://api.slack.com/img/blocks/bkb_template_images/tripAgent_1.png",
+        alt_text: "Windsor Court Hotel thumbnail"
+      )
+    ),
+    b.context(
+      elements: [
+        b.image(
+          image_url: "https://api.slack.com/img/blocks/bkb_template_images/tripAgentLocationMarker.png",
+          alt_text: "Location Pin Icon"
+        ),
+        b.plain_text(text: "Location: Central Business District", emoji: true)
+      ]
+    )
+  ]
+end
+
+puts blocks.to_json
+```
+
+You will get this.
+![message example](https://user-images.githubusercontent.com/724270/167278001-2235d8b6-9d4b-47dd-b5ba-13880383f89b.png)
+
+##
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/slack_valid_block_kit. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the SlackValidBlockKit project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/slack_valid_block_kit/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "slack_valid_block_kit"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/slack_valid_block_kit/builder/compositions.rb

@@ -0,0 +1,59 @@
+module SlackValidBlockKit
+  module Builder
+    module Compositions
+      def plain_text(text:, emoji: nil)
+        hash = { type: 'plain_text' }
+        hash[:text] = text
+        hash[:emoji] = emoji unless emoji.nil?
+        hash
+      end
+
+      def mrkdwn(text:, verbatim: nil)
+        hash = { type: 'mrkdwn' }
+        hash[:text] = text
+        hash[:verbatim] = verbatim unless verbatim.nil?
+        hash
+      end
+
+      def confirmation(title:, text:, confirm:, deny:, style: nil)
+        hash = {}
+        hash[:title] = title
+        hash[:text] = text
+        hash[:confirm] = confirm
+        hash[:deny] = deny
+        hash[:style] = style unless style.nil?
+        hash
+      end
+
+      def option(text:, value:, description: nil, url: nil)
+        hash = {}
+        hash[:text] = text
+        hash[:value] = value
+        hash[:description] = description unless description.nil?
+        hash[:url] = url unless url.nil?
+        hash
+      end
+
+      def option_group(label:, options:)
+        hash = {}
+        hash[:label] = label
+        hash[:options] = options
+        hash
+      end
+
+      def dispatch_action_configuration(trigger_actions_on: nil)
+        hash = {}
+        hash[:trigger_actions_on] = trigger_actions_on unless trigger_actions_on.nil?
+        hash
+      end
+
+      def filter(include: nil, exclude_external_shared_channels: nil, exclude_bot_users: nil)
+        hash = {}
+        hash[:include] = include unless include.nil?
+        hash[:exclude_external_shared_channels] = exclude_external_shared_channels unless exclude_external_shared_channels.nil?
+        hash[:exclude_bot_users] = exclude_bot_users unless exclude_bot_users.nil?
+        hash
+      end
+    end
+  end
+end

data/lib/slack_valid_block_kit/builder/elements.rb

@@ -0,0 +1,202 @@
+module SlackValidBlockKit
+  module Builder
+    module Elements
+      def button(text:, action_id:, url: nil, value: nil, style: nil, confirm: nil, accessibility_label: nil)
+        hash = { type: 'button' }
+        hash[:text] = text
+        hash[:action_id] = action_id
+        hash[:url] = url unless url.nil?
+        hash[:value] = value unless value.nil?
+        hash[:style] = style unless style.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:accessibility_label] = accessibility_label unless accessibility_label.nil?
+        hash
+      end
+
+      def checkboxes(action_id:, options:, initial_options: nil, confirm: nil, focus_on_load: nil)
+        hash = { type: 'checkboxes' }
+        hash[:action_id] = action_id
+        hash[:options] = options
+        hash[:initial_options] = initial_options unless initial_options.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def datepicker(action_id:, placeholder: nil, initial_date: nil, confirm: nil, focus_on_load: nil)
+        hash = { type: 'datepicker' }
+        hash[:action_id] = action_id
+        hash[:placeholder] = placeholder unless placeholder.nil?
+        hash[:initial_date] = initial_date unless initial_date.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def image(image_url:, alt_text:)
+        hash = { type: 'image' }
+        hash[:image_url] = image_url
+        hash[:alt_text] = alt_text
+        hash
+      end
+
+      def multi_static_select(placeholder:, action_id:, options:, option_groups: nil, initial_options: nil, confirm: nil, max_selected_items: nil, focus_on_load: nil)
+        hash = { type: 'multi_static_select' }
+        hash[:placeholder] = placeholder
+        hash[:action_id] = action_id
+        hash[:options] = options
+        hash[:option_groups] = option_groups unless option_groups.nil?
+        hash[:initial_options] = initial_options unless initial_options.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:max_selected_items] = max_selected_items unless max_selected_items.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def multi_external_select(placeholder:, action_id:, min_query_length: nil, initial_options: nil, confirm: nil, max_selected_items: nil, focus_on_load: nil)
+        hash = { type: 'multi_external_select' }
+        hash[:placeholder] = placeholder
+        hash[:action_id] = action_id
+        hash[:min_query_length] = min_query_length unless min_query_length.nil?
+        hash[:initial_options] = initial_options unless initial_options.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:max_selected_items] = max_selected_items unless max_selected_items.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def multi_users_select(placeholder:, action_id:, initial_users: nil, confirm: nil, max_selected_items: nil, focus_on_load: nil)
+        hash = { type: 'multi_users_select' }
+        hash[:placeholder] = placeholder
+        hash[:action_id] = action_id
+        hash[:initial_users] = initial_users unless initial_users.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:max_selected_items] = max_selected_items unless max_selected_items.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def multi_conversations_select(placeholder:, action_id:, initial_conversations: nil, default_to_current_conversation: nil, confirm: nil, max_selected_items: nil, filter: nil, focus_on_load: nil)
+        hash = { type: 'multi_conversations_select' }
+        hash[:placeholder] = placeholder
+        hash[:action_id] = action_id
+        hash[:initial_conversations] = initial_conversations unless initial_conversations.nil?
+        hash[:default_to_current_conversation] = default_to_current_conversation unless default_to_current_conversation.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:max_selected_items] = max_selected_items unless max_selected_items.nil?
+        hash[:filter] = filter unless filter.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def multi_channels_select(placeholder:, action_id:, initial_channels: nil, confirm: nil, max_selected_items: nil, focus_on_load: nil)
+        hash = { type: 'multi_channels_select' }
+        hash[:placeholder] = placeholder
+        hash[:action_id] = action_id
+        hash[:initial_channels] = initial_channels unless initial_channels.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:max_selected_items] = max_selected_items unless max_selected_items.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def overflow(options:, action_id:, confirm: nil)
+        hash = { type: 'overflow' }
+        hash[:options] = options
+        hash[:action_id] = action_id
+        hash[:confirm] = confirm unless confirm.nil?
+        hash
+      end
+
+      def plain_text_input(action_id:, placeholder: nil, initial_value: nil, multiline: nil, min_length: nil, max_length: nil, dispatch_action_config: nil, focus_on_load: nil)
+        hash = { type: 'plain_text_input' }
+        hash[:action_id] = action_id
+        hash[:placeholder] = placeholder unless placeholder.nil?
+        hash[:initial_value] = initial_value unless initial_value.nil?
+        hash[:multiline] = multiline unless multiline.nil?
+        hash[:min_length] = min_length unless min_length.nil?
+        hash[:max_length] = max_length unless max_length.nil?
+        hash[:dispatch_action_config] = dispatch_action_config unless dispatch_action_config.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def radio_buttons(options:, action_id:, initial_option: nil, confirm: nil, focus_on_load: nil)
+        hash = { type: 'radio_buttons' }
+        hash[:options] = options
+        hash[:action_id] = action_id
+        hash[:initial_option] = initial_option unless initial_option.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def static_select(placeholder:, action_id:, options:, option_groups: nil, initial_option: nil, confirm: nil, focus_on_load: nil)
+        hash = { type: 'static_select' }
+        hash[:placeholder] = placeholder
+        hash[:action_id] = action_id
+        hash[:options] = options
+        hash[:option_groups] = option_groups unless option_groups.nil?
+        hash[:initial_option] = initial_option unless initial_option.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def external_select(placeholder:, action_id:, min_query_length: nil, initial_option: nil, confirm: nil, focus_on_load: nil)
+        hash = { type: 'external_select' }
+        hash[:placeholder] = placeholder
+        hash[:action_id] = action_id
+        hash[:min_query_length] = min_query_length unless min_query_length.nil?
+        hash[:initial_option] = initial_option unless initial_option.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def users_select(placeholder:, action_id:, initial_user: nil, confirm: nil, focus_on_load: nil)
+        hash = { type: 'users_select' }
+        hash[:placeholder] = placeholder
+        hash[:action_id] = action_id
+        hash[:initial_user] = initial_user unless initial_user.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def conversations_select(placeholder:, action_id:, initial_conversation: nil, default_to_current_conversation: nil, confirm: nil, response_url_enabled: nil, filter: nil, focus_on_load: nil)
+        hash = { type: 'conversations_select' }
+        hash[:placeholder] = placeholder
+        hash[:action_id] = action_id
+        hash[:initial_conversation] = initial_conversation unless initial_conversation.nil?
+        hash[:default_to_current_conversation] = default_to_current_conversation unless default_to_current_conversation.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:response_url_enabled] = response_url_enabled unless response_url_enabled.nil?
+        hash[:filter] = filter unless filter.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def channels_select(placeholder:, action_id:, initial_channel: nil, confirm: nil, response_url_enabled: nil, focus_on_load: nil)
+        hash = { type: 'channels_select' }
+        hash[:placeholder] = placeholder
+        hash[:action_id] = action_id
+        hash[:initial_channel] = initial_channel unless initial_channel.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:response_url_enabled] = response_url_enabled unless response_url_enabled.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+
+      def timepicker(action_id:, placeholder: nil, initial_time: nil, confirm: nil, focus_on_load: nil)
+        hash = { type: 'timepicker' }
+        hash[:action_id] = action_id
+        hash[:placeholder] = placeholder unless placeholder.nil?
+        hash[:initial_time] = initial_time unless initial_time.nil?
+        hash[:confirm] = confirm unless confirm.nil?
+        hash[:focus_on_load] = focus_on_load unless focus_on_load.nil?
+        hash
+      end
+    end
+  end
+end

data/lib/slack_valid_block_kit/builder/layouts.rb

@@ -0,0 +1,69 @@
+module SlackValidBlockKit
+  module Builder
+    module Layouts
+      def actions(elements:, block_id: nil)
+        hash = { type: 'actions' }
+        hash[:elements] = elements
+        hash[:block_id] = block_id unless block_id.nil?
+        hash
+      end
+
+      def context(elements:, block_id: nil)
+        hash = { type: 'context' }
+        hash[:elements] = elements
+        hash[:block_id] = block_id unless block_id.nil?
+        hash
+      end
+
+      def divider(block_id: nil)
+        hash = { type: 'divider' }
+        hash[:block_id] = block_id unless block_id.nil?
+        hash
+      end
+
+      def file(elements:, source:, block_id: nil)
+        hash = { type: 'file' }
+        hash[:elements] = elements
+        hash[:source] = source
+        hash[:block_id] = block_id unless block_id.nil?
+        hash
+      end
+
+      def header(text:, block_id: nil)
+        hash = { type: 'header' }
+        hash[:text] = text
+        hash[:block_id] = block_id unless block_id.nil?
+        hash
+      end
+
+      def image(image_url:, alt_text:, title: nil, block_id: nil)
+        hash = { type: 'image' }
+        hash[:image_url] = image_url
+        hash[:alt_text] = alt_text
+        hash[:title] = title unless title.nil?
+        hash[:block_id] = block_id unless block_id.nil?
+        hash
+      end
+
+      def input(label:, element:, dispatch_action: nil, block_id: nil, hint: nil, optional: nil)
+        hash = { type: 'input' }
+        hash[:label] = label
+        hash[:element] = element
+        hash[:dispatch_action] = dispatch_action unless dispatch_action.nil?
+        hash[:block_id] = block_id unless block_id.nil?
+        hash[:hint] = hint unless hint.nil?
+        hash[:optional] = optional unless optional.nil?
+        hash
+      end
+
+      def section(text: nil, block_id: nil, fields: nil, accessory: nil)
+        hash = { type: 'section' }
+        hash[:text] = text unless text.nil?
+        hash[:block_id] = block_id unless block_id.nil?
+        hash[:fields] = fields unless fields.nil?
+        hash[:accessory] = accessory unless accessory.nil?
+        hash
+      end
+    end
+  end
+end