bundleup-sdk 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 979b84801f81102d120f0a9936fda8d851ee68551017d1a7876dbe0530024601
-  data.tar.gz: c1c5a77941501aa6d2c49c11f5f1906462bfd6b9d376f080a87b1d22f9131ba9
+  metadata.gz: 6e385086d7a4207cb36ec82ac134eab03155093407c098488ea40478d62f79d3
+  data.tar.gz: ca70fa9281ad486160c66a731e81c0ad56f200ad4e8fccf15e818340e43ea5d6
 SHA512:
-  metadata.gz: 7d936f5585a32fa86e47e841033cc70e01d7abd314ded883ad6586e248f71744f04de434fa8442b6adcb36fe8d1070e7b500d543c3356452d781ae1e562f048a
-  data.tar.gz: d990e1de94e7f89c0cf25ae2c6165c65a2db6d81a6d03017cc107a105dee96680a3cfcb227f3c4e565bf6ab731f861f56fdcb6f1766273412f0d029ac28fd790
+  metadata.gz: 9245dcc515bff7307c4073bbc223ce3b2e5bdd8e3ff91dbb83cfdf95437c89bc7e03a7c3b8c9c0db0ca2bb0962df0c9597d127c0a3209d2bcb909e934c787f65
+  data.tar.gz: e472e19410d920eb5fbbe6abab03c2af1d1ea05945d7249d1be90c7d47ab7375d67dc503ba2698e57ce7b40ed9fed423400847b3dffefde47b51931c5ee74117

data/README.md

@@ -24,7 +24,6 @@ Official Ruby SDK for the [BundleUp](https://bundleup.io) API. Connect to 100+ i
 - [Development](#development)
 - [Contributing](#contributing)
 - [License](#license)
-- [Support](#support)
 
 ## Installation
 
@@ -84,7 +83,7 @@ Runnable examples are available in the [`examples/`](./examples) directory:
 
 - [`examples/basic_usage.rb`](./examples/basic_usage.rb) - Client setup, connections, integrations, and webhooks
 - [`examples/proxy_api.rb`](./examples/proxy_api.rb) - Proxy API GET request with a connection
-- [`examples/unify_api.rb`](./examples/unify_api.rb) - Unify Chat, Git, and PM endpoint usage
+- [`examples/unify_api.rb`](./examples/unify_api.rb) - Unify Chat, Git, PM, Ticketing, and Drive endpoint usage
 - [`examples/README.md`](./examples/README.md) - Setup and execution instructions
 
 ## Quick Start
@@ -641,6 +640,43 @@ unify = client.unify('conn_123abc')
 
 The Chat API provides a unified interface for chat platforms like Slack, Discord, and Microsoft Teams.
 
+##### List Users
+
+Retrieve a list of users from the connected chat platform.
+
+```ruby
+result = unify.chat.users(
+  limit: 100,
+  after: nil,
+  include_raw: false
+)
+
+puts "Users: #{result['data']}"
+puts "Next cursor: #{result['metadata']['next']}"
+```
+
+**Parameters:**
+
+- `limit` (Integer, optional): Maximum number of users to return (default: 100, max: 1000)
+- `after` (String, optional): Pagination cursor from previous response
+- `include_raw` (Boolean, optional): Include raw API response from the integration (default: false)
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => 'U1234567890',
+      'name' => 'Jane Doe'
+    }
+  ],
+  'metadata' => {
+    'next' => 'cursor_abc123'
+  }
+}
+```
+
 ##### List Channels
 
 Retrieve a list of channels from the connected chat platform.
@@ -701,6 +737,31 @@ end
 puts "Fetched #{all_channels.length} total channels"
 ```
 
+##### Send Message
+
+Send a message to a channel on the connected chat platform.
+
+```ruby
+result = unify.chat.message('C1234567890', 'Hello from BundleUp! :wave:')
+
+puts "Message sent: #{result['data']}"
+```
+
+**Parameters:**
+
+- `channel_id` (String, required): The ID of the channel to send the message to
+- `text` (String, required): Markdown-formatted message text
+
+**Response:**
+
+```ruby
+{
+  'data' => {
+    # Raw response data from the chat provider
+  }
+}
+```
+
 #### Git API
 
 The Git API provides a unified interface for version control platforms like GitHub, GitLab, and Bitbucket.
@@ -841,20 +902,45 @@ puts "Releases: #{result['data']}"
 }
 ```
 
-#### Project Management API
+##### List Branches
 
-The PM API provides a unified interface for project management platforms like Jira, Linear, and Asana.
+```ruby
+result = unify.git.branches('organization/repo-name', limit: 50)
 
-##### List Issues
+puts "Branches: #{result['data']}"
+```
+
+**Response:**
 
 ```ruby
-result = unify.pm.issues(
+{
+  'data' => [
+    {
+      'name' => 'main',
+      'commit_sha' => 'abc123def456',
+      'protected' => true
+    }
+  ],
+  'metadata' => {
+    'next' => nil
+  }
+}
+```
+
+#### Ticketing API
+
+The Ticketing API provides a unified interface for ticketing and project management platforms like Jira, Linear, and Asana.
+
+##### List Tickets
+
+```ruby
+result = unify.ticketing.tickets(
   limit: 100,
   after: nil,
   include_raw: false
 )
 
-puts "Issues: #{result['data']}"
+puts "Tickets: #{result['data']}"
 ```
 
 **Response:**
@@ -881,8 +967,108 @@ puts "Issues: #{result['data']}"
 **Filtering and sorting:**
 
 ```ruby
-open_issues = result['data'].select { |issue| issue['status'] == 'open' }
-sorted_by_date = result['data'].sort_by { |issue| Time.parse(issue['created_at']) }.reverse
+open_tickets = result['data'].select { |ticket| ticket['status'] == 'open' }
+sorted_by_date = result['data'].sort_by { |ticket| Time.parse(ticket['created_at']) }.reverse
+```
+
+#### CRM API
+
+The CRM API provides a unified interface for CRM platforms like Attio, HubSpot, PipeDrive, Salesforce and Zoho.
+
+##### List Companies
+
+```ruby
+result = unify.crm.companies(
+  limit: 100,
+  after: nil,
+  include_raw: false
+)
+
+puts "Companies: #{result['data']}"
+```
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => '12345',
+      'name' => 'Acme Inc.',
+      'website' => 'https://acme.example.com'
+    }
+  ],
+  'metadata' => {
+    'next' => nil
+  }
+}
+```
+
+##### List Contacts
+
+```ruby
+result = unify.crm.contacts(
+  limit: 100,
+  after: nil,
+  include_raw: false
+)
+
+puts "Contacts: #{result['data']}"
+```
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => '67890',
+      'name' => 'Jane Doe',
+      'email' => 'jane@acme.example.com'
+    }
+  ],
+  'metadata' => {
+    'next' => nil
+  }
+}
+```
+
+#### Drive API
+
+The Drive API provides a unified interface for file storage platforms like Google Drive, OneDrive, Box, Dropbox and Microsoft SharePoint.
+
+##### List Files
+
+```ruby
+result = unify.drive.files(
+  limit: 100,
+  after: nil,
+  include_raw: false
+)
+
+puts "Files: #{result['data']}"
+```
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => 'file_123',
+      'name' => 'quarterly-report.pdf',
+      'mime_type' => 'application/pdf',
+      'size' => 204800,
+      'created_at' => '2024-01-15T10:30:00Z',
+      'updated_at' => '2024-01-20T14:22:00Z',
+      'url' => 'https://drive.example.com/file_123',
+      'is_folder' => false
+    }
+  ],
+  'metadata' => {
+    'next' => nil
+  }
+}
 ```
 
 ## Error Handling
@@ -938,10 +1124,22 @@ lib/
 │       ├── base.rb          # Base Unify class
 │       ├── chat.rb          # Chat Unify API
 │       ├── git.rb           # Git Unify API
-│       └── pm.rb            # PM Unify API
+│       ├── ticketing.rb     # Ticketing Unify API
+│       ├── crm.rb           # CRM Unify API
+│       └── drive.rb         # Drive Unify API
+sig/                         # RBS type signatures (mirrors lib/)
 spec/                        # Test files
 ```
 
+### Type Signatures
+
+The gem ships [RBS](https://github.com/ruby/rbs) signatures for the Unify API under `sig/bundleup/unify/`. They're optional at runtime (deleting `sig/` doesn't change behavior) but give editors and `rbs` itself static types for `unify.chat.channels`, `unify.git.repos`, and so on.
+
+```bash
+# Validate the signature files
+bundle exec rake sig
+```
+
 ### Running Tests
 
 ```bash
@@ -1050,39 +1248,6 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## Support
-
-Need help? We're here for you!
-
-### Documentation
-
-- **Official Docs**: [https://docs.bundleup.io](https://docs.bundleup.io)
-- **API Reference**: [https://docs.bundleup.io/api](https://docs.bundleup.io/api)
-- **SDK Guides**: [https://docs.bundleup.io/sdk/ruby](https://docs.bundleup.io/sdk/ruby)
-
-### Community
-
-- **Discord**: [https://discord.gg/bundleup](https://discord.gg/bundleup)
-- **GitHub Discussions**: [https://github.com/bundleup/bundleup-sdk-ruby/discussions](https://github.com/bundleup/bundleup-sdk-ruby/discussions)
-- **Stack Overflow**: Tag your questions with `bundleup`
-
-### Direct Support
-
-- **Email**: [support@bundleup.io](mailto:support@bundleup.io)
-- **GitHub Issues**: [https://github.com/bundleup/bundleup-sdk-ruby/issues](https://github.com/bundleup/bundleup-sdk-ruby/issues)
-- **Twitter**: [@bundleup_io](https://twitter.com/bundleup_io)
-
-### Enterprise Support
-
-For enterprise customers, we offer:
-
-- Priority support with SLA
-- Dedicated support channel
-- Architecture consultation
-- Custom integration assistance
-
-Contact [enterprise@bundleup.io](mailto:enterprise@bundleup.io) for more information.
-
 ## Code of Conduct
 
 Everyone interacting in the BundleUp project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/bundleup/bundleup-sdk-ruby/blob/main/CODE_OF_CONDUCT).

data/lib/bundleup/unify/chat.rb

@@ -4,6 +4,17 @@ module BundleUp
   module Unify
     # Client for chat-related Unify endpoints.
     class Chat < Base
+      # Fetches users from the connected chat provider.
+      def users(params = {})
+        response = connection.get('chat/users') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch chat/users: #{response.status}" unless response.success?
+
+        response.body
+      end
+
       # Fetches channels from the connected chat provider.
       def channels(params = {})
         response = connection.get('chat/channels') do |req|
@@ -14,6 +25,19 @@ module BundleUp
 
         response.body
       end
+
+      # Sends a message to a channel on the connected chat provider.
+      def message(channel_id, text)
+        raise ArgumentError, 'channel_id is required to send a message.' if channel_id.nil?
+
+        encoded_channel_id = URI.encode_www_form_component(channel_id)
+
+        response = connection.post("chat/channels/#{encoded_channel_id}/message", { text: text }.to_json)
+
+        raise "Failed to post chat/channels/#{encoded_channel_id}/message: #{response.status}" unless response.success?
+
+        response.body
+      end
     end
   end
 end

data/lib/bundleup/unify/crm.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # Client for CRM-related Unify endpoints.
+    class CRM < Base
+      # Fetches companies from the connected CRM provider.
+      def companies(params = {})
+        response = connection.get('crm/companies') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch crm/companies: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      # Fetches contacts from the connected CRM provider.
+      def contacts(params = {})
+        response = connection.get('crm/contacts') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch crm/contacts: #{response.status}" unless response.success?
+
+        response.body
+      end
+    end
+  end
+end

data/lib/bundleup/unify/drive.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # Client for Drive-related Unify endpoints.
+    class Drive < Base
+      # Fetches files from the connected Drive provider.
+      def files(params = {})
+        response = connection.get('drive/files') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch drive/files: #{response.status}" unless response.success?
+
+        response.body
+      end
+    end
+  end
+end

data/lib/bundleup/unify/git.rb

@@ -53,6 +53,19 @@ module BundleUp
 
         response.body
       end
+
+      # Fetches branches for a specific repository from the connected Git provider.
+      def branches(repo_name, params = {})
+        encoded_repo_name = URI.encode_www_form_component(repo_name)
+
+        response = connection.get("git/repos/#{encoded_repo_name}/branches") do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch git/repos/#{encoded_repo_name}/branches: #{response.status}" unless response.success?
+
+        response.body
+      end
     end
   end
 end

data/lib/bundleup/unify/ticketing.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # Client for ticketing Unify endpoints.
+    class Ticketing < Base
+      # Fetches tickets from the connected ticketing tool.
+      def tickets(params = {})
+        response = connection.get('ticketing/tickets') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch ticketing/tickets: #{response.status}" unless response.success?
+
+        response.body
+      end
+    end
+  end
+end

data/lib/bundleup/unify.rb

@@ -7,9 +7,38 @@ module BundleUp
       attr_reader :api_key, :connection_id
 
       def initialize(api_key, connection_id)
-        @pm = BundleUp::Unify::PM.new(api_key, connection_id)
+        @ticketing = BundleUp::Unify::Ticketing.new(api_key, connection_id)
         @chat = BundleUp::Unify::Chat.new(api_key, connection_id)
         @git = BundleUp::Unify::Git.new(api_key, connection_id)
+        @crm = BundleUp::Unify::CRM.new(api_key, connection_id)
+        @drive = BundleUp::Unify::Drive.new(api_key, connection_id)
+        @api_key = api_key
+        @connection_id = connection_id
+      end
+
+      # Access the Chat API for the connection.
+      def chat
+        @chat ||= BundleUp::Unify::Chat.new(api_key, connection_id)
+      end
+
+      # Access the Git API for the connection.
+      def git
+        @git ||= BundleUp::Unify::Git.new(api_key, connection_id)
+      end
+
+      # Access the CRM API for the connection.
+      def crm
+        @crm ||= BundleUp::Unify::CRM.new(api_key, connection_id)
+      end
+
+      # Access the Ticketing API for the connection.
+      def ticketing
+        @ticketing ||= BundleUp::Unify::Ticketing.new(api_key, connection_id)
+      end
+
+      # Access the Drive API for the connection.
+      def drive
+        @drive ||= BundleUp::Unify::Drive.new(api_key, connection_id)
       end
     end
   end

data/lib/bundleup/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BundleUp
-  VERSION = '0.2.2'
+  VERSION = '0.3.0'
 end

data/lib/bundleup.rb

@@ -17,7 +17,9 @@ require_relative 'bundleup/resources/webhook'
 require_relative 'bundleup/unify/base'
 require_relative 'bundleup/unify/chat'
 require_relative 'bundleup/unify/git'
-require_relative 'bundleup/unify/pm'
+require_relative 'bundleup/unify/ticketing'
+require_relative 'bundleup/unify/crm'
+require_relative 'bundleup/unify/drive'
 
 # Main module for the BundleUp SDK.
 module BundleUp

data/sig/bundleup/unify/base.rbs

@@ -0,0 +1,17 @@
+module BundleUp
+  module Unify
+    class Base
+      BASE_URL: String
+      API_VERSION: String
+
+      attr_reader api_key: String
+      attr_reader connection_id: String
+
+      def initialize: (String api_key, String connection_id) -> void
+
+      private
+
+      def connection: () -> Faraday::Connection
+    end
+  end
+end

data/sig/bundleup/unify/chat.rbs

@@ -0,0 +1,13 @@
+module BundleUp
+  module Unify
+    class Chat < Base
+      type chat_user = { id: String, name: String }
+      type chat_channel = { id: String, name: String }
+      type metadata = { next: String? }
+
+      def users: (?Hash[Symbol, untyped] params) -> { data: Array[chat_user], metadata: metadata }
+      def channels: (?Hash[Symbol, untyped] params) -> { data: Array[chat_channel], metadata: metadata }
+      def message: (String channel_id, String text) -> { data: Hash[String, untyped] }
+    end
+  end
+end

data/sig/bundleup/unify/crm.rbs

@@ -0,0 +1,12 @@
+module BundleUp
+  module Unify
+    class CRM < Base
+      type crm_company = { id: String, name: String, website: String? }
+      type crm_contact = { id: String, name: String, email: String? }
+      type metadata = { next: String? }
+
+      def companies: (?Hash[Symbol, untyped] params) -> { data: Array[crm_company], metadata: metadata }
+      def contacts: (?Hash[Symbol, untyped] params) -> { data: Array[crm_contact], metadata: metadata }
+    end
+  end
+end

data/sig/bundleup/unify/drive.rbs

@@ -0,0 +1,20 @@
+module BundleUp
+  module Unify
+    class Drive < Base
+      type drive_file = {
+        id: String,
+        name: String,
+        mime_type: String?,
+        size: Integer?,
+        created_at: String?,
+        updated_at: String?,
+        url: String?,
+        is_folder: bool
+      }
+
+      type metadata = { next: String? }
+
+      def files: (?Hash[Symbol, untyped] params) -> { data: Array[drive_file], metadata: metadata }
+    end
+  end
+end

data/sig/bundleup/unify/git.rbs

@@ -0,0 +1,53 @@
+module BundleUp
+  module Unify
+    class Git < Base
+      type git_repo = {
+        id: Integer | String,
+        name: String,
+        full_name: String,
+        description: String?,
+        url: String,
+        created_at: String,
+        updated_at: String,
+        pushed_at: String
+      }
+
+      type git_pull = {
+        id: Integer,
+        number: Integer,
+        title: String,
+        description: String?,
+        draft: bool,
+        state: String,
+        url: String,
+        user: String,
+        created_at: String,
+        updated_at: String,
+        merged_at: String?
+      }
+
+      type git_tag = { name: String, commit_sha: String }
+
+      type git_release = {
+        id: Integer,
+        name: String,
+        tag_name: String,
+        description: String,
+        prerelease: bool,
+        url: String,
+        created_at: String,
+        released_at: String
+      }
+
+      type git_branch = { name: String, commit_sha: String, protected: bool }
+
+      type metadata = { next: String? }
+
+      def repos: (?Hash[Symbol, untyped] params) -> { data: Array[git_repo], metadata: metadata }
+      def pulls: (String repo_name, ?Hash[Symbol, untyped] params) -> { data: Array[git_pull], metadata: metadata }
+      def tags: (String repo_name, ?Hash[Symbol, untyped] params) -> { data: Array[git_tag], metadata: metadata }
+      def releases: (String repo_name, ?Hash[Symbol, untyped] params) -> { data: Array[git_release], metadata: metadata }
+      def branches: (String repo_name, ?Hash[Symbol, untyped] params) -> { data: Array[git_branch], metadata: metadata }
+    end
+  end
+end

data/sig/bundleup/unify/ticketing.rbs

@@ -0,0 +1,19 @@
+module BundleUp
+  module Unify
+    class Ticketing < Base
+      type ticketing_ticket = {
+        id: String,
+        title: String,
+        status: String,
+        url: String,
+        description: String?,
+        created_at: String,
+        updated_at: String
+      }
+
+      type metadata = { next: String? }
+
+      def issues: (?Hash[Symbol, untyped] params) -> { data: Array[ticketing_ticket], metadata: metadata }
+    end
+  end
+end

data/sig/bundleup/unify.rbs

@@ -0,0 +1,16 @@
+module BundleUp
+  module Unify
+    class Client
+      attr_reader api_key: String
+      attr_reader connection_id: String
+
+      def initialize: (String api_key, String connection_id) -> void
+
+      def chat: () -> Chat
+      def git: () -> Git
+      def pm: () -> PM
+      def crm: () -> CRM
+      def drive: () -> Drive
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bundleup-sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - BundleUp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-28 00:00:00.000000000 Z
+date: 2026-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rbs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -66,6 +80,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: rubocop-capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.23'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.23'
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
@@ -148,9 +176,18 @@ files:
 - lib/bundleup/unify.rb
 - lib/bundleup/unify/base.rb
 - lib/bundleup/unify/chat.rb
+- lib/bundleup/unify/crm.rb
+- lib/bundleup/unify/drive.rb
 - lib/bundleup/unify/git.rb
-- lib/bundleup/unify/pm.rb
+- lib/bundleup/unify/ticketing.rb
 - lib/bundleup/version.rb
+- sig/bundleup/unify.rbs
+- sig/bundleup/unify/base.rbs
+- sig/bundleup/unify/chat.rbs
+- sig/bundleup/unify/crm.rbs
+- sig/bundleup/unify/drive.rbs
+- sig/bundleup/unify/git.rbs
+- sig/bundleup/unify/ticketing.rbs
 homepage: https://github.com/bundleup/bundleup-sdk-ruby
 licenses:
 - MIT

data/lib/bundleup/unify/pm.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module BundleUp
-  module Unify
-    # Client for project management Unify endpoints.
-    class PM < Base
-      # Fetches issues from the connected project management tool.
-      def issues(params = {})
-        response = connection.get('pm/issues') do |req|
-          req.params = params
-        end
-
-        raise "Failed to fetch pm/issues: #{response.status}" unless response.success?
-
-        response.body
-      end
-    end
-  end
-end