lex-slack 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a28ca3cf73693e96c723d9aa4422fc736faaf822dda847b25c600a89b9b2db64
-  data.tar.gz: 98129cc2f88ddf76e8e5b7698d11d4bb24bb59853d3b3ef74342df4f18dff06b
+  metadata.gz: 792ea5ec2fb4bb3991a58b84a7ddd261cc6b8a8a89e0dd402e3e9eba9d9eeb4a
+  data.tar.gz: 7f95c2db6113a183bf6ed8568d3f0f22cf1670f538f104b41a04fb1caea98fda
 SHA512:
-  metadata.gz: 44f872c9d2d0b4442c0ce15575bf61542f339700ba68276305dee03772f80c9b388ea1b6a8becef218fe68a35d6626b109fdbe3f53a9fe1befbe35580bf4c2bd
-  data.tar.gz: 11eb73245b9c89cf0891356f0477424cdc7fa3e26f543fba2c51a91e48b4ea89e4134335b41a4764020ff917025694ccc448da7b85f22cc49454d2fea94da68b
+  metadata.gz: f09185b9193cbf274f571983a44abb5540c8f404ca4e7327c5cdc266002710204460d71e78315ab6e3e03569fcedad76e06f0e6c178e6ce67b59490833190791
+  data.tar.gz: 15625764b7d0b206ea2a28f6427d0e634332765f9d817895b1b0a2a74991a64413a7e54f351a5d670350d58d50480ce3d31f7201cedb2bd54fbeade74d17111c

data/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  ci:
+    uses: LegionIO/.github/.github/workflows/ci.yml@main
+
+  release:
+    needs: ci
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    uses: LegionIO/.github/.github/workflows/release.yml@main
+    secrets:
+      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,56 @@
+AllCops:
+  TargetRubyVersion: 3.4
+  NewCops: enable
+  SuggestExtensions: false
+
+Layout/LineLength:
+  Max: 160
+
+Layout/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: space
+
+Layout/HashAlignment:
+  EnforcedHashRocketStyle: table
+  EnforcedColonStyle: table
+
+Metrics/MethodLength:
+  Max: 50
+
+Metrics/ClassLength:
+  Max: 1500
+
+Metrics/ModuleLength:
+  Max: 1500
+
+Metrics/BlockLength:
+  Max: 200
+  Exclude:
+    - 'spec/**/*'
+
+Metrics/ParameterLists:
+  Max: 8
+
+Naming/MethodParameterName:
+  MinNameLength: 2
+
+Metrics/AbcSize:
+  Max: 60
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/PerceivedComplexity:
+  Max: 17
+
+Style/Documentation:
+  Enabled: false
+
+Style/SymbolArray:
+  Enabled: true
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+Naming/FileName:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+## [0.3.0] - 2026-03-20
+
+### Added
+- Named connection builders: `api_connection` (Slack Web API) and `webhook_connection` (incoming webhooks)
+- Runners::Blocks - Block Kit builder (section, divider, header, actions, context, image, input, button, select, datepicker, etc.)
+- Runners::Chat - post_message, send_webhook, update_message, delete_message, schedule_message, delete_scheduled
+- Runners::Conversations - list, info, history, replies, members, join, leave, invite, open, create, archive, set_topic
+- Runners::Users - list, info, lookup_by_email, get_presence, set_presence
+- Runners::Reactions - add, remove, get, list
+- Runners::Files - upload (two-step external), list, info, delete, share
+- Runners::Pins - add, remove, list
+- Runners::Bookmarks - add, edit, remove, list
+- Runners::Reminders - add, complete, delete, info, list
+- Runners::Usergroups - create, update, disable, enable, list, list_users, update_users
+- Runners::Views - open, push, update, publish
+- Runners::Search - search_messages, search_files
+- Actor::MessagePoller - configurable channel polling with high-water mark tracking (disabled by default)
+- Standalone Client including all runners with automatic credential injection
+
+### Changed
+- Complete rebuild from v0.2.0
+- Dropped `multi_json` dependency (unused)
+- Renamed `Runners::User` to `Runners::Users` (plural, matches API resource)
+- Replaced single `client` helper with named `api_connection`/`webhook_connection` builders
+
+### Removed
+- Old `Helpers::Client#client` method (replaced by named builders)
+
+## [0.2.0] - 2026-03-15
+
+### Added
+- `Runners::User` with `list_users`, `user_info`, `set_presence`, and `get_presence` methods using Slack Web API Bearer token auth
+- Standalone `Client` class that includes `Helpers::Client`, `Runners::Chat`, and `Runners::User` for use outside the Legion runtime
+- Specs for `Client`, `Runners::Chat` (expanded), and `Runners::User`
+
+## [0.1.0] - 2026-03-13
+
+### Added
+- Initial release

data/CLAUDE.md

@@ -0,0 +1,89 @@
+# lex-slack: Slack Integration for LegionIO
+
+**Repository Level 3 Documentation**
+- **Parent**: `/Users/miverso2/rubymine/legion/extensions-other/CLAUDE.md`
+- **Grandparent**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
+
+## Purpose
+
+Comprehensive Legion Extension connecting LegionIO to Slack. Covers the Slack Web API (messaging, conversations, users, reactions, files, pins, bookmarks, reminders, usergroups, views, search), incoming webhooks, Block Kit builder, and a configurable message polling actor.
+
+**Version**: 0.3.0
+**GitHub**: https://github.com/LegionIO/lex-slack
+**License**: MIT
+
+## Architecture
+
+```
+Legion::Extensions::Slack
++-- Helpers/
+|   +-- Client             # Named builders: api_connection (Web API), webhook_connection
++-- Runners/
+|   +-- Blocks             # Pure Block Kit builder (no HTTP)
+|   +-- Chat               # post_message, send_webhook, update, delete, schedule (6 methods)
+|   +-- Conversations      # list, info, history, replies, members, join, leave, invite, open, create, archive, topic (12 methods)
+|   +-- Users              # list, info, lookup_by_email, presence (5 methods)
+|   +-- Reactions          # add, remove, get, list (4 methods)
+|   +-- Files              # upload (two-step), list, info, delete, share (5 methods)
+|   +-- Pins               # add, remove, list (3 methods)
+|   +-- Bookmarks          # add, edit, remove, list (4 methods)
+|   +-- Reminders          # add, complete, delete, info, list (5 methods)
+|   +-- Usergroups         # CRUD + users.list/update (7 methods)
+|   +-- Views              # open, push, update, publish (4 methods)
+|   +-- Search             # search_messages, search_files (2 methods)
++-- Actors/
+|   +-- MessagePoller      # Poll conversations.history (disabled by default)
++-- Client                 # Standalone client including all runners
+```
+
+## Connection Builders
+
+Two named Faraday connection builders in `Helpers::Client`:
+- `api_connection(token:, base_url:, **)` — targets `https://slack.com/api/`, Bearer token auth
+- `webhook_connection(base_url:, **)` — targets `https://hooks.slack.com`, no auth
+
+All runners use `api_connection` except `Chat#send_webhook` which uses `webhook_connection`.
+
+## Standalone Client
+
+`Client.new(token:, webhook:, **)` stores credentials in `@opts` and injects them into every connection call via `super(**@opts, **override)`. All 12 runner modules are included. Per-call token override supported.
+
+## Actor: MessagePoller
+
+Configurable polling actor, disabled by default. Settings:
+
+```json
+{
+  "lex-slack": {
+    "token": "xoxb-...",
+    "poller": {
+      "enabled": false,
+      "interval": 30,
+      "channels": [],
+      "limit": 50
+    }
+  }
+}
+```
+
+Uses in-memory high-water mark per channel. Publishes to Legion transport if available.
+
+## Dependencies
+
+| Gem | Purpose |
+|-----|---------|
+| `faraday` (>= 2.0) | HTTP client |
+
+## Development
+
+141 specs across 16 spec files.
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+---
+
+**Maintained By**: Matthew Iverson (@Esity)

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'bundler', '>= 2'
+gem 'rake'
+gem 'rspec'
+gem 'rubocop'

data/Gemfile.lock

@@ -0,0 +1,88 @@
+PATH
+  remote: .
+  specs:
+    lex-slack (0.3.0)
+      faraday (>= 2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.9)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    bigdecimal (4.0.1)
+    diff-lcs (1.6.2)
+    faraday (2.14.1)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    json (2.19.1)
+    json-schema (6.2.0)
+      addressable (~> 2.8)
+      bigdecimal (>= 3.1, < 5)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    mcp (0.8.0)
+      json-schema (>= 4.1)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    parallel (1.27.0)
+    parser (3.3.10.2)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    public_suffix (7.0.5)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (12.3.3)
+    regexp_parser (2.11.3)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.85.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      mcp (~> 0.6)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+
+PLATFORMS
+  arm64-darwin-25
+  ruby
+
+DEPENDENCIES
+  bundler (>= 2)
+  lex-slack!
+  rake
+  rspec
+  rubocop
+
+BUNDLED WITH
+   2.6.9

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Esity
+
+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,223 @@
+# lex-slack
+
+Comprehensive Slack integration for [LegionIO](https://github.com/LegionIO/LegionIO). Covers the Slack Web API (messaging, conversations, users, reactions, files, pins, bookmarks, reminders, usergroups, views, search), incoming webhooks, Block Kit builder, and a configurable message polling actor.
+
+## Installation
+
+```bash
+gem install lex-slack
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'lex-slack'
+```
+
+## Standalone Client
+
+Use `Legion::Extensions::Slack::Client` outside the full LegionIO framework. The client stores credentials and injects them into every API call automatically.
+
+```ruby
+require 'legion/extensions/slack'
+
+client = Legion::Extensions::Slack::Client.new(token: 'xoxb-...')
+
+# Messaging
+client.post_message(channel: '#general', text: 'Hello from Legion!')
+client.post_message(channel: '#alerts', text: 'fallback', blocks: [
+  client.header(text: 'Incident Alert'),
+  client.section(text: client.mrkdwn('*web-prod-03* is unreachable')),
+  client.divider,
+  client.actions(elements: [
+    client.button(text: 'Acknowledge', action_id: 'ack', style: 'primary'),
+    client.button(text: 'Escalate', action_id: 'esc', style: 'danger')
+  ])
+])
+
+# Conversations
+channels = client.list_conversations
+history = client.conversation_history(channel: 'C123ABC')
+
+# Users
+users = client.list_users
+user = client.lookup_by_email(email: 'jane.doe@example.com')
+
+# Reactions
+client.add_reaction(channel: 'C123', timestamp: '1234.5678', name: 'thumbsup')
+
+# Files (two-step upload)
+client.upload_file(filename: 'report.csv', content: csv_data, channel: '#reports')
+
+# Webhooks (no token needed)
+webhook_client = Legion::Extensions::Slack::Client.new(webhook: '/services/T.../B.../...')
+webhook_client.send_webhook(message: 'Quick alert!')
+```
+
+## Runners
+
+### Chat
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `post_message` | `channel:, text:, blocks:, thread_ts:` | Post a message (supports Block Kit) |
+| `send_webhook` | `message:, webhook:` | Post via incoming webhook |
+| `update_message` | `channel:, ts:, text:, blocks:` | Update an existing message |
+| `delete_message` | `channel:, ts:` | Delete a message |
+| `schedule_message` | `channel:, text:, post_at:` | Schedule a future message |
+| `delete_scheduled` | `channel:, scheduled_message_id:` | Cancel a scheduled message |
+
+### Conversations
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `list_conversations` | `types:, cursor:, limit:` | List channels |
+| `conversation_info` | `channel:` | Get channel details |
+| `conversation_history` | `channel:, oldest:, latest:` | Fetch message history |
+| `conversation_replies` | `channel:, ts:` | Fetch thread replies |
+| `conversation_members` | `channel:` | List channel members |
+| `join_conversation` | `channel:` | Join a channel |
+| `leave_conversation` | `channel:` | Leave a channel |
+| `invite_to_conversation` | `channel:, users:` | Invite users to a channel |
+| `open_conversation` | `users:` | Open or resume a DM |
+| `create_conversation` | `name:, is_private:` | Create a channel |
+| `archive_conversation` | `channel:` | Archive a channel |
+| `set_conversation_topic` | `channel:, topic:` | Set the channel topic |
+
+### Users
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `list_users` | `cursor:, limit:` | List workspace users |
+| `user_info` | `user:` | Get user details |
+| `lookup_by_email` | `email:` | Find user by email |
+| `get_presence` | `user:` | Get presence status |
+| `set_presence` | `presence:` | Set bot presence (`auto`/`away`) |
+
+### Reactions
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `add_reaction` | `channel:, timestamp:, name:` | Add a reaction |
+| `remove_reaction` | `channel:, timestamp:, name:` | Remove a reaction |
+| `get_reactions` | `channel:, timestamp:` | Get reactions on a message |
+| `list_reactions` | `user:, cursor:` | List reactions by a user |
+
+### Files
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `upload_file` | `filename:, content:, channel:` | Upload via two-step external flow |
+| `list_files` | `channel:, user:, types:` | List files |
+| `file_info` | `file:` | Get file details |
+| `delete_file` | `file:` | Delete a file |
+| `share_file` | `file:` | Create a public URL for a file |
+
+### Pins
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `add_pin` | `channel:, timestamp:` | Pin a message |
+| `remove_pin` | `channel:, timestamp:` | Unpin a message |
+| `list_pins` | `channel:` | List pinned items |
+
+### Bookmarks
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `add_bookmark` | `channel:, title:, type:, link:` | Add a bookmark |
+| `edit_bookmark` | `channel:, bookmark_id:` | Edit a bookmark |
+| `remove_bookmark` | `channel:, bookmark_id:` | Remove a bookmark |
+| `list_bookmarks` | `channel:` | List bookmarks |
+
+### Reminders
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `add_reminder` | `text:, time:, user:` | Create a reminder |
+| `complete_reminder` | `reminder:` | Mark complete |
+| `delete_reminder` | `reminder:` | Delete a reminder |
+| `reminder_info` | `reminder:` | Get reminder details |
+| `list_reminders` | | List all reminders |
+
+### Usergroups
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `list_usergroups` | `include_users:, include_disabled:` | List usergroups |
+| `create_usergroup` | `name:, handle:` | Create a usergroup |
+| `update_usergroup` | `usergroup:, name:` | Update a usergroup |
+| `disable_usergroup` | `usergroup:` | Disable a usergroup |
+| `enable_usergroup` | `usergroup:` | Re-enable a usergroup |
+| `list_usergroup_users` | `usergroup:` | List members |
+| `update_usergroup_users` | `usergroup:, users:` | Set members |
+
+### Views
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `open_view` | `trigger_id:, view:` | Open a modal |
+| `push_view` | `trigger_id:, view:` | Push a view onto the stack |
+| `update_view` | `view_id:, view:` | Update an existing view |
+| `publish_view` | `user_id:, view:` | Publish an App Home tab |
+
+### Search
+
+| Method | Key Parameters | Description |
+|--------|---------------|-------------|
+| `search_messages` | `query:, sort:, count:` | Search messages (requires user token) |
+| `search_files` | `query:, sort:, count:` | Search files (requires user token) |
+
+### Blocks (Builder)
+
+Pure Ruby helpers for constructing Block Kit payloads. No HTTP calls.
+
+| Method | Description |
+|--------|-------------|
+| `mrkdwn(text)` | Markdown text object |
+| `plain_text(text)` | Plain text object |
+| `option(text:, value:)` | Select menu option |
+| `section(text:, accessory:, fields:)` | Section block |
+| `divider` | Divider block |
+| `header(text:)` | Header block |
+| `context(elements:)` | Context block |
+| `actions(elements:)` | Actions block |
+| `image(image_url:, alt_text:)` | Image block |
+| `input(label:, element:)` | Input block |
+| `file_block(external_id:)` | File block |
+| `button(text:, action_id:)` | Button element |
+| `overflow_menu(action_id:, options:)` | Overflow menu |
+| `static_select(action_id:, placeholder:, options:)` | Static select |
+| `multi_static_select(action_id:, placeholder:, options:)` | Multi-select |
+| `datepicker(action_id:)` | Date picker |
+
+## Message Poller Actor
+
+A configurable polling actor that watches channels for new messages. Disabled by default.
+
+Configure via Legion::Settings:
+
+```json
+{
+  "lex-slack": {
+    "token": "xoxb-...",
+    "poller": {
+      "enabled": true,
+      "interval": 30,
+      "channels": ["C123ABC", "C456DEF"],
+      "limit": 50
+    }
+  }
+}
+```
+
+The poller uses an in-memory high-water mark per channel to avoid reprocessing messages. New messages are published to Legion transport if available.
+
+## Requirements
+
+- Ruby >= 3.4
+- `faraday` >= 2.0
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lex-slack.gemspec

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative 'lib/legion/extensions/slack/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'lex-slack'
+  spec.version       = Legion::Extensions::Slack::VERSION
+  spec.authors       = ['Esity']
+  spec.email         = ['matthewdiverson@gmail.com']
+
+  spec.summary       = 'LEX::Slack'
+  spec.description   = 'Connects Legion to Slack via Web API and incoming webhooks'
+  spec.homepage      = 'https://github.com/LegionIO/lex-slack'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.4'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/LegionIO/lex-slack'
+  spec.metadata['documentation_uri'] = 'https://github.com/LegionIO/lex-slack'
+  spec.metadata['changelog_uri'] = 'https://github.com/LegionIO/lex-slack'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/LegionIO/lex-slack/issues'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'faraday', '>= 2.0'
+end