feat(block-kit): add data_table layout block

slack-api-client/src/main/java/com/slack/api/util/json/GsonFactory.java

@@ -11,6 +11,7 @@
 import com.slack.api.model.block.ContextBlockElement;
 import com.slack.api.model.block.ContextActionsBlockElement;
 import com.slack.api.model.block.LayoutBlock;
+import com.slack.api.model.block.composition.TableCell;
 import com.slack.api.model.block.composition.TextObject;
 import com.slack.api.model.block.element.BlockElement;
 import com.slack.api.model.block.element.RichTextElement;
@@ -80,6 +81,7 @@ public static void registerTypeAdapters(GsonBuilder builder, boolean failOnUnkno
                 .registerTypeAdapter(ContextActionsBlockElement.class, new GsonContextActionsBlockElementFactory(failOnUnknownProps))
                 .registerTypeAdapter(BlockElement.class, new GsonBlockElementFactory(failOnUnknownProps))
                 .registerTypeAdapter(RichTextElement.class, new GsonRichTextElementFactory(failOnUnknownProps))
+                .registerTypeAdapter(TableCell.class, new GsonTableCellFactory(failOnUnknownProps))
                 .registerTypeAdapter(FunctionExecutedEvent.InputValue.class, new GsonFunctionExecutedEventInputValueFactory())
                 .registerTypeAdapter(Attachment.VideoHtml.class, new GsonMessageAttachmentVideoHtmlFactory(failOnUnknownProps))
                 .registerTypeAdapter(MessageChangedEvent.PreviousMessage.class, new GsonMessageChangedEventPreviousMessageFactory(failOnUnknownProps))

slack-api-model/src/main/java/com/slack/api/model/block/Blocks.java

@@ -159,6 +159,12 @@ public static ContainerBlock container(ModelConfigurator<ContainerBlock.Containe
         return configurator.configure(ContainerBlock.builder()).build();
     }
 
+    // DataTableBlock
+
+    public static DataTableBlock dataTable(ModelConfigurator<DataTableBlock.DataTableBlockBuilder> configurator) {
+        return configurator.configure(DataTableBlock.builder()).build();
+    }
+
     // TaskCardBlock
 
     public static TaskCardBlock taskCard(ModelConfigurator<TaskCardBlock.TaskCardBlockBuilder> configurator) {

slack-api-model/src/main/java/com/slack/api/model/block/DataTableBlock.java

@@ -0,0 +1,48 @@
+package com.slack.api.model.block;
+
+import com.slack.api.model.block.composition.TableCell;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * Displays rich tables that support pagination, sorting, filtering, and interactivity.
+ *
+ * @see <a href="https://docs.slack.dev/reference/block-kit/blocks/data-table-block">Data table block</a>
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class DataTableBlock implements LayoutBlock {
+    public static final String TYPE = "data_table";
+    private final String type = TYPE;
+
+    /**
+     * An array consisting of table rows.
+     */
+    @Builder.Default
+    private List<List<TableCell>> rows = new ArrayList<>();
+
+    /**
+     * A caption for the table; used as the value for the HTML caption element.
+     */
+    private String caption;
+
+    /**
+     * Number of rows per page. Min {@code 1}, Max {@code 100}. Defaults to {@code 5} if omitted.
+     */
+    private Integer pageSize;
+
+    /**
+     * The 0-based index of the column that uniquely identifies each row (the row header). This column
+     * is treated as the row's primary identifier for screen readers. Defaults to {@code 0} if omitted.
+     */
+    private Integer rowHeaderColumnIndex;
+
+    private String blockId;
+}

slack-api-model/src/main/java/com/slack/api/model/block/RichTextBlock.java

@@ -1,5 +1,6 @@
 package com.slack.api.model.block;
 
+import com.slack.api.model.block.composition.TableCell;
 import com.slack.api.model.block.element.BlockElement;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
@@ -16,7 +17,7 @@
 @Builder
 @NoArgsConstructor
 @AllArgsConstructor
-public class RichTextBlock implements LayoutBlock {
+public class RichTextBlock implements LayoutBlock, TableCell {
     public static final String TYPE = "rich_text";
     private final String type = TYPE;
     @Builder.Default

slack-api-model/src/main/java/com/slack/api/model/block/composition/ActionCellObject.java

@@ -0,0 +1,31 @@
+package com.slack.api.model.block.composition;
+
+import com.slack.api.model.block.element.ButtonElement;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Defines a cell containing a button. Action cells can only be used in the data table block, not the table block.
+ *
+ * @see <a href="https://docs.slack.dev/reference/block-kit/blocks/data-table-block">Data table block</a>
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ActionCellObject implements TableCell {
+    public static final String TYPE = "action_cell";
+    private final String type = TYPE;
+
+    /**
+     * A button element.
+     */
+    private ButtonElement element;
+
+    /**
+     * A raw_text or raw_number cell.
+     */
+    private TableCell fallback;
+}

slack-api-model/src/main/java/com/slack/api/model/block/composition/BlockCompositions.java

@@ -1,6 +1,7 @@
 package com.slack.api.model.block.composition;
 
 import com.slack.api.model.ModelConfigurator;
+import com.slack.api.model.block.element.ButtonElement;
 
 import java.util.Arrays;
 import java.util.List;
@@ -22,6 +23,16 @@ public static List<OptionObject> asOptions(OptionObject... options) {
         return Arrays.asList(options);
     }
 
+    // ActionCellObject
+
+    public static ActionCellObject actionCell(ModelConfigurator<ActionCellObject.ActionCellObjectBuilder> configurator) {
+        return configurator.configure(ActionCellObject.builder()).build();
+    }
+
+    public static ActionCellObject actionCell(ButtonElement element) {
+        return ActionCellObject.builder().element(element).build();
+    }
+
     // ConfirmationDialogObject
 
     public static ConfirmationDialogObject confirmationDialog(
@@ -54,6 +65,26 @@ public static MarkdownTextObject markdownText(String text) {
         return MarkdownTextObject.builder().text(text).build();
     }
 
+    // RawNumberObject
+
+    public static RawNumberObject rawNumber(ModelConfigurator<RawNumberObject.RawNumberObjectBuilder> configurator) {
+        return configurator.configure(RawNumberObject.builder()).build();
+    }
+
+    public static RawNumberObject rawNumber(Double value, String text) {
+        return RawNumberObject.builder().value(value).text(text).build();
+    }
+
+    // RawTextObject
+
+    public static RawTextObject rawText(ModelConfigurator<RawTextObject.RawTextObjectBuilder> configurator) {
+        return configurator.configure(RawTextObject.builder()).build();
+    }
+
+    public static RawTextObject rawText(String text) {
+        return RawTextObject.builder().text(text).build();
+    }
+
     // OptionGroupObject
 
     public static OptionGroupObject optionGroup(ModelConfigurator<OptionGroupObject.OptionGroupObjectBuilder> configurator) {

slack-api-model/src/main/java/com/slack/api/model/block/composition/RawNumberObject.java

@@ -0,0 +1,30 @@
+package com.slack.api.model.block.composition;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Defines an object containing a numeric value.
+ *
+ * @see <a href="https://docs.slack.dev/reference/block-kit/blocks/data-table-block">Data table block</a>
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class RawNumberObject implements TableCell {
+    public static final String TYPE = "raw_number";
+    private final String type = TYPE;
+
+    /**
+     * The numeric value.
+     */
+    private Double value;
+
+    /**
+     * The text used to display the value. The minimum length is 1 character.
+     */
+    private String text;
+}

slack-api-model/src/main/java/com/slack/api/model/block/composition/RawTextObject.java

@@ -0,0 +1,25 @@
+package com.slack.api.model.block.composition;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Defines an object containing some text.
+ *
+ * @see <a href="https://docs.slack.dev/reference/block-kit/blocks/data-table-block">Data table block</a>
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class RawTextObject implements TableCell {
+    public static final String TYPE = "raw_text";
+    private final String type = TYPE;
+
+    /**
+     * The text for the block. The minimum length is 1 character.
+     */
+    private String text;
+}

slack-api-model/src/main/java/com/slack/api/model/block/composition/TableCell.java

@@ -0,0 +1,19 @@
+package com.slack.api.model.block.composition;
+
+/**
+ * A single cell within a table or data table row. A cell can be one of:
+ *
+ * <ul>
+ *   <li>{@link ActionCellObject} ({@code action_cell}), in data table blocks only</li>
+ *   <li>{@link RawTextObject} ({@code raw_text})</li>
+ *   <li>{@link RawNumberObject} ({@code raw_number})</li>
+ *   <li>{@link com.slack.api.model.block.RichTextBlock RichTextBlock} ({@code rich_text})</li>
+ * </ul>
+ *
+ * @see <a href="https://docs.slack.dev/reference/block-kit/blocks/data-table-block">Data table block</a>
+ */
+public interface TableCell {
+
+    String getType();
+
+}

slack-api-model/src/main/java/com/slack/api/model/block/composition/UnknownTableCell.java

@@ -0,0 +1,17 @@
+package com.slack.api.model.block.composition;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * https://docs.slack.dev/reference/block-kit/blocks/data-table-block
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class UnknownTableCell implements TableCell {
+    private String type;
+}

slack-api-model/src/main/java/com/slack/api/util/json/GsonLayoutBlockFactory.java

@@ -51,6 +51,8 @@ private Class<? extends LayoutBlock> getLayoutClassInstance(String typeName) {
                 return ContextActionsBlock.class;
             case ContextBlock.TYPE:
                 return ContextBlock.class;
+            case DataTableBlock.TYPE:
+                return DataTableBlock.class;
             case DividerBlock.TYPE:
                 return DividerBlock.class;
             case FileBlock.TYPE:

slack-api-model/src/main/java/com/slack/api/util/json/GsonTableCellFactory.java

@@ -0,0 +1,64 @@
+package com.slack.api.util.json;
+
+import com.google.gson.*;
+import com.slack.api.model.block.RichTextBlock;
+import com.slack.api.model.block.composition.ActionCellObject;
+import com.slack.api.model.block.composition.RawNumberObject;
+import com.slack.api.model.block.composition.RawTextObject;
+import com.slack.api.model.block.composition.TableCell;
+import com.slack.api.model.block.composition.UnknownTableCell;
+
+import java.lang.reflect.Type;
+
+/**
+ * Factory for deserializing the cells of a
+ * {@link com.slack.api.model.block.DataTableBlock data table block}.
+ *
+ * @see <a href="https://docs.slack.dev/reference/block-kit/blocks/data-table-block">Data table block</a>
+ */
+public class GsonTableCellFactory implements JsonDeserializer<TableCell>, JsonSerializer<TableCell> {
+
+    private final boolean failOnUnknownProperties;
+
+    public GsonTableCellFactory() {
+        this(false);
+    }
+
+    public GsonTableCellFactory(boolean failOnUnknownProperties) {
+        this.failOnUnknownProperties = failOnUnknownProperties;
+    }
+
+    @Override
+    public TableCell deserialize(JsonElement json, Type typeOfT, JsonDeserializationContext context)
+            throws JsonParseException {
+        final JsonObject jsonObject = json.getAsJsonObject();
+        final JsonPrimitive prim = (JsonPrimitive) jsonObject.get("type");
+        final String typeName = prim.getAsString();
+        final Class<? extends TableCell> clazz = getTableCellClassInstance(typeName);
+        return context.deserialize(jsonObject, clazz);
+    }
+
+    @Override
+    public JsonElement serialize(TableCell src, Type typeOfSrc, JsonSerializationContext context) {
+        return context.serialize(src);
+    }
+
+    private Class<? extends TableCell> getTableCellClassInstance(String typeName) {
+        switch (typeName) {
+            case ActionCellObject.TYPE:
+                return ActionCellObject.class;
+            case RawTextObject.TYPE:
+                return RawTextObject.class;
+            case RawNumberObject.TYPE:
+                return RawNumberObject.class;
+            case RichTextBlock.TYPE:
+                return RichTextBlock.class;
+            default:
+                if (failOnUnknownProperties) {
+                    throw new JsonParseException("Unknown table cell type: " + typeName);
+                } else {
+                    return UnknownTableCell.class;
+                }
+        }
+    }
+}