bundleup-sdk 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9265bf377a655ed9056e02bd22d1ec24fec68304e7ad4881c99013c42ca516f2
-  data.tar.gz: 4f9dac8314ce2d26640048984f7bef53e8921dfa9d4a7be5c5857412af5d3b00
+  metadata.gz: a3feaef0f54fcef0ff3dba477b926513d0ed0801e2f383a80b0ca13f44218c5a
+  data.tar.gz: d44bc81b00d6afa88e0b4d58de1f832a98d81538f00a6169d3f5838e52865d1f
 SHA512:
-  metadata.gz: 9e24b6ae2f52e09f5a2eb65e697b1080b4f8a36c5052097ea660b145fec36c7b85aef08ce85979d21023e65aa2788b4444071993e2f3ba3ea5b1f11bdbd2b48f
-  data.tar.gz: 71008902408646b7d4e171c186bc28337f0b67c7b36e218f01b2cf637402b06edf27cc2fa070dd036a35d9d428eecdad51f7935e1f2618e7dfdbd61b92b2949e
+  metadata.gz: 95b41fa793e45e3aaa62f01beda29dce8172b5547da1e5959c0c4cf6927de71fca5892f9c2d8d2a87a1fecc3a43af53c7cc2139e1afff4a215f3c5287a057a9d
+  data.tar.gz: e597e588f6cd074e365660d54908ef489e456fcec0b9f5238c87ad946be29b007e636fb541439429fd25a6b6486fa89c535eab2d4c76e5dd824d0427248d8b6d

data/README.md

@@ -84,7 +84,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, PM, Ticketing, Drive, and Calendar endpoint usage
+- [`examples/unify_api.rb`](./examples/unify_api.rb) - Unify Chat, Git, Tasks, Helpdesk, Drive, and Calendar endpoint usage
 - [`examples/README.md`](./examples/README.md) - Setup and execution instructions
 
 ## Quick Start
@@ -542,6 +542,16 @@ url = client.auth.build_authorization_url(
 # Redirect the user to `url`
 ```
 
+The URL needs no API key, so you can also build it without a client:
+
+```ruby
+url = BundleUp.build_authorization_url(
+  client_id: 'your-client-id',
+  integration_id: 'github',
+  redirect_uri: 'https://app.example.com/callback'
+)
+```
+
 **Parameters:**
 
 - `client_id` (String, required): Your workspace client ID
@@ -1084,20 +1094,20 @@ provider's default branch is used.
 }
 ```
 
-#### Ticketing API
+#### Tasks API
 
-The Ticketing API provides a unified interface for ticketing and project management platforms like Jira, Linear, and Asana.
+The Tasks API provides a unified interface for issue trackers and project management tools like Jira, Linear, Asana, Trello, ClickUp, monday.com, Basecamp, Wrike, and Todoist.
 
-##### List Tickets
+##### List Tasks
 
 ```ruby
-result = unify.ticketing.tickets(
+result = unify.tasks.tasks(
   limit: 100,
   after: nil,
   include_raw: false
 )
 
-puts "Tickets: #{result['data']}"
+puts "Tasks: #{result['data']}"
 ```
 
 **Response:**
@@ -1124,18 +1134,18 @@ puts "Tickets: #{result['data']}"
 **Filtering and sorting:**
 
 ```ruby
-open_tickets = result['data'].select { |ticket| ticket['status'] == 'open' }
-sorted_by_date = result['data'].sort_by { |ticket| Time.parse(ticket['created_at']) }.reverse
+open_tasks = result['data'].select { |task| task['status'] == 'open' }
+sorted_by_date = result['data'].sort_by { |task| Time.parse(task['created_at']) }.reverse
 ```
 
-##### Get a Ticket
+##### Get a Task
 
-Fetch one ticket by ID. Not supported by Basecamp, whose API only serves a to-do underneath its project.
+Fetch one task by ID. Not supported by Basecamp, whose API only serves a to-do underneath its project.
 
 ```ruby
-result = unify.ticketing.ticket('PROJ-123')
+result = unify.tasks.task('PROJ-123')
 
-puts "Ticket: #{result['data']}"
+puts "Task: #{result['data']}"
 ```
 
 **Response:**
@@ -1159,7 +1169,7 @@ A single resource carries no pagination, so there is no `metadata` on this respo
 ##### List Projects
 
 ```ruby
-result = unify.ticketing.projects(
+result = unify.tasks.projects(
   limit: 100,
   after: nil,
   include_raw: false
@@ -1191,6 +1201,57 @@ puts "Projects: #{result['data']}"
 
 **Note:** Not every platform returns every field. Jira does not expose creation or update timestamps for projects, so `created_at` and `updated_at` are `nil` for Jira connections, and `status` is only set when Jira reports whether the project is archived.
 
+#### Helpdesk API
+
+The Helpdesk API provides a unified interface for customer support tools like Zendesk, ServiceNow, Zoho Desk, Gorgias, and Help Scout.
+
+##### List Tickets
+
+```ruby
+result = unify.helpdesk.tickets(
+  limit: 100,
+  after: nil,
+  include_raw: false
+)
+
+puts "Tickets: #{result['data']}"
+```
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => '4182',
+      'title' => 'Refund for order #1043',
+      'description' => 'Hi, my order arrived damaged...',
+      'status' => 'open',
+      'priority' => 'high',
+      'requester' => { 'id' => '381920', 'name' => 'Dana Ruiz', 'email' => 'dana@example.com' },
+      'url' => 'https://acme.zendesk.com/agent/tickets/4182',
+      'created_at' => '2024-01-15T10:30:00Z',
+      'updated_at' => '2024-01-20T14:22:00Z'
+    }
+  ],
+  'metadata' => {
+    'next' => 'cursor_def456'
+  }
+}
+```
+
+##### Get a Ticket
+
+Fetch one support ticket by ID. On ServiceNow the ID is the incident's `sys_id`.
+
+```ruby
+result = unify.helpdesk.ticket('4182')
+
+puts "Ticket: #{result['data']}"
+```
+
+A single resource carries no pagination, so there is no `metadata` on this response.
+
 #### CRM API
 
 The CRM API provides a unified interface for CRM platforms like Attio, HubSpot, PipeDrive, Salesforce and Zoho.
@@ -1552,7 +1613,8 @@ lib/
 │       ├── base.rb          # Base Unify class
 │       ├── chat.rb          # Chat Unify API
 │       ├── git.rb           # Git Unify API
-│       ├── ticketing.rb     # Ticketing Unify API
+│       ├── tasks.rb         # Tasks Unify API
+│       ├── helpdesk.rb      # Helpdesk Unify API
 │       ├── crm.rb           # CRM Unify API
 │       ├── drive.rb         # Drive Unify API
 │       └── calendar.rb      # Calendar Unify API

data/lib/bundleup/auth.rb

@@ -14,7 +14,10 @@ module BundleUp
     end
 
     # Builds the hosted authorization URL to send the end user to.
-    def build_authorization_url(client_id:, integration_id:, redirect_uri:, external_id: nil, state: nil)
+    #
+    # Needs no API key: /authorize only takes the public client and
+    # integration ids, so this is safe to call where the key must not live.
+    def self.build_authorization_url(client_id:, integration_id:, redirect_uri:, external_id: nil, state: nil)
       raise ArgumentError, 'client_id is required' if blank?(client_id)
       raise ArgumentError, 'integration_id is required' if blank?(integration_id)
       raise ArgumentError, 'redirect_uri is required' if blank?(redirect_uri)
@@ -30,6 +33,16 @@ module BundleUp
       "#{BASE_URL}/authorize?#{URI.encode_www_form(params)}"
     end
 
+    def self.blank?(value)
+      value.nil? || value.to_s.empty?
+    end
+    private_class_method :blank?
+
+    # Builds the hosted authorization URL to send the end user to.
+    def build_authorization_url(**params)
+      self.class.build_authorization_url(**params)
+    end
+
     # Exchanges the one-time code from the redirect for the connection.
     # Call this server-side; the code expires after 5 minutes and works once.
     # Returns { 'connection_id', 'external_id', 'integration_id' }.

data/lib/bundleup/unify/helpdesk.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # Client for helpdesk Unify endpoints (customer support tools).
+    class Helpdesk < Base
+      # Fetches support tickets from the connected helpdesk.
+      def tickets(params = {})
+        response = connection.get('helpdesk/tickets') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch helpdesk/tickets: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      # Fetches a single support ticket by ID (a sys_id on ServiceNow).
+      def ticket(ticket_id, params = {})
+        raise ArgumentError, 'ticket_id is required to fetch a ticket.' if blank?(ticket_id)
+
+        encoded_id = URI.encode_www_form_component(ticket_id)
+
+        response = connection.get("helpdesk/tickets/#{encoded_id}") do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch helpdesk/tickets/#{encoded_id}: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      private
+
+      def blank?(value)
+        value.nil? || value.to_s.empty?
+      end
+    end
+  end
+end

data/lib/bundleup/unify/tasks.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # Client for tasks Unify endpoints (issue trackers and project tools).
+    class Tasks < Base
+      # Fetches tasks from the connected issue tracker or project tool.
+      def tasks(params = {})
+        response = connection.get('tasks/tasks') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch tasks/tasks: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      # Fetches a single task by ID from the connected issue tracker or project tool.
+      #
+      # Not supported by Basecamp, whose API only serves a to-do underneath its
+      # project — an id on its own cannot address one.
+      def task(task_id, params = {})
+        raise ArgumentError, 'task_id is required to fetch a task.' if blank?(task_id)
+
+        encoded_id = URI.encode_www_form_component(task_id)
+
+        response = connection.get("tasks/tasks/#{encoded_id}") do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch tasks/tasks/#{encoded_id}: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      # Fetches projects from the connected issue tracker or project tool.
+      def projects(params = {})
+        response = connection.get('tasks/projects') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch tasks/projects: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      private
+
+      def blank?(value)
+        value.nil? || value.to_s.empty?
+      end
+    end
+  end
+end

data/lib/bundleup/unify.rb

@@ -7,7 +7,8 @@ module BundleUp
       attr_reader :api_key, :connection_id
 
       def initialize(api_key, connection_id)
-        @ticketing = BundleUp::Unify::Ticketing.new(api_key, connection_id)
+        @tasks = BundleUp::Unify::Tasks.new(api_key, connection_id)
+        @helpdesk = BundleUp::Unify::Helpdesk.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)
@@ -32,9 +33,14 @@ module BundleUp
         @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)
+      # Access the Tasks API (issue trackers and project tools) for the connection.
+      def tasks
+        @tasks ||= BundleUp::Unify::Tasks.new(api_key, connection_id)
+      end
+
+      # Access the Helpdesk API (customer support tools) for the connection.
+      def helpdesk
+        @helpdesk ||= BundleUp::Unify::Helpdesk.new(api_key, connection_id)
       end
 
       # Access the Drive API for the connection.

data/lib/bundleup/version.rb

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

data/lib/bundleup.rb

@@ -19,7 +19,8 @@ require_relative 'bundleup/resources/webhook'
 require_relative 'bundleup/unify/base'
 require_relative 'bundleup/unify/chat'
 require_relative 'bundleup/unify/git'
-require_relative 'bundleup/unify/ticketing'
+require_relative 'bundleup/unify/tasks'
+require_relative 'bundleup/unify/helpdesk'
 require_relative 'bundleup/unify/crm'
 require_relative 'bundleup/unify/drive'
 require_relative 'bundleup/unify/calendar'
@@ -27,4 +28,9 @@ require_relative 'bundleup/unify/me'
 
 # Main module for the BundleUp SDK.
 module BundleUp
+  # Builds the hosted authorization URL without an API key.
+  # See BundleUp::Auth.build_authorization_url.
+  def self.build_authorization_url(**params)
+    Auth.build_authorization_url(**params)
+  end
 end

data/sig/bundleup/auth.rbs

@@ -1,4 +1,12 @@
 module BundleUp
+  def self.build_authorization_url: (
+    client_id: String,
+    integration_id: String,
+    redirect_uri: String,
+    ?external_id: String?,
+    ?state: String?
+  ) -> String
+
   class Auth
     BASE_URL: String
 
@@ -12,6 +20,16 @@ module BundleUp
 
     def initialize: (String api_key) -> void
 
+    def self.blank?: (untyped value) -> bool
+
+    def self.build_authorization_url: (
+      client_id: String,
+      integration_id: String,
+      redirect_uri: String,
+      ?external_id: String?,
+      ?state: String?
+    ) -> String
+
     def build_authorization_url: (
       client_id: String,
       integration_id: String,

data/sig/bundleup/unify/helpdesk.rbs

@@ -0,0 +1,33 @@
+module BundleUp
+  module Unify
+    class Helpdesk < Base
+      type requester = {
+        id: String?,
+        name: String?,
+        email: String?
+      }
+
+      type ticket = {
+        id: String,
+        title: String?,
+        description: String?,
+        status: String?,
+        priority: String?,
+        requester: requester?,
+        url: String?,
+        created_at: String?,
+        updated_at: String?
+      }
+
+      type metadata = { next: String? }
+
+      def tickets: (?Hash[Symbol, untyped] params) -> { data: Array[ticket], metadata: metadata }
+
+      def ticket: (String ticket_id, ?Hash[Symbol, untyped] params) -> { data: ticket }
+
+      private
+
+      def blank?: (untyped) -> bool
+    end
+  end
+end

data/sig/bundleup/unify/{ticketing.rbs → tasks.rbs}

@@ -1,7 +1,7 @@
 module BundleUp
   module Unify
-    class Ticketing < Base
-      type ticketing_ticket = {
+    class Tasks < Base
+      type task_item = {
         id: String,
         title: String,
         status: String,
@@ -11,7 +11,7 @@ module BundleUp
         updated_at: String
       }
 
-      type ticket = {
+      type task = {
         id: String,
         title: String,
         status: String?,
@@ -21,7 +21,7 @@ module BundleUp
         updated_at: String?
       }
 
-      type ticketing_project = {
+      type project = {
         id: String,
         name: String,
         status: String?,
@@ -33,11 +33,11 @@ module BundleUp
 
       type metadata = { next: String? }
 
-      def tickets: (?Hash[Symbol, untyped] params) -> { data: Array[ticketing_ticket], metadata: metadata }
+      def tasks: (?Hash[Symbol, untyped] params) -> { data: Array[task_item], metadata: metadata }
 
-      def ticket: (String ticket_id, ?Hash[Symbol, untyped] params) -> { data: ticket }
+      def task: (String task_id, ?Hash[Symbol, untyped] params) -> { data: task }
 
-      def projects: (?Hash[Symbol, untyped] params) -> { data: Array[ticketing_project], metadata: metadata }
+      def projects: (?Hash[Symbol, untyped] params) -> { data: Array[project], metadata: metadata }
 
       private
 

data/sig/bundleup/unify.rbs

@@ -8,7 +8,8 @@ module BundleUp
 
       def chat: () -> Chat
       def git: () -> Git
-      def ticketing: () -> Ticketing
+      def tasks: () -> Tasks
+      def helpdesk: () -> Helpdesk
       def crm: () -> CRM
       def drive: () -> Drive
       def calendar: () -> Calendar

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bundleup-sdk
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - BundleUp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-02 00:00:00.000000000 Z
+date: 2026-10-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -182,8 +182,9 @@ files:
 - lib/bundleup/unify/crm.rb
 - lib/bundleup/unify/drive.rb
 - lib/bundleup/unify/git.rb
+- lib/bundleup/unify/helpdesk.rb
 - lib/bundleup/unify/me.rb
-- lib/bundleup/unify/ticketing.rb
+- lib/bundleup/unify/tasks.rb
 - lib/bundleup/version.rb
 - sig/bundleup/auth.rbs
 - sig/bundleup/unify.rbs
@@ -193,8 +194,9 @@ files:
 - sig/bundleup/unify/crm.rbs
 - sig/bundleup/unify/drive.rbs
 - sig/bundleup/unify/git.rbs
+- sig/bundleup/unify/helpdesk.rbs
 - sig/bundleup/unify/me.rbs
-- sig/bundleup/unify/ticketing.rbs
+- sig/bundleup/unify/tasks.rbs
 homepage: https://github.com/bundleup/bundleup-sdk-ruby
 licenses:
 - MIT

data/lib/bundleup/unify/ticketing.rb

@@ -1,54 +0,0 @@
-# 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
-
-      # Fetches a single ticket by ID from the connected ticketing tool.
-      #
-      # Not supported by Basecamp, whose API only serves a to-do underneath its
-      # project — an id on its own cannot address one.
-      def ticket(ticket_id, params = {})
-        raise ArgumentError, 'ticket_id is required to fetch a ticket.' if blank?(ticket_id)
-
-        encoded_id = URI.encode_www_form_component(ticket_id)
-
-        response = connection.get("ticketing/tickets/#{encoded_id}") do |req|
-          req.params = params
-        end
-
-        raise "Failed to fetch ticketing/tickets/#{encoded_id}: #{response.status}" unless response.success?
-
-        response.body
-      end
-
-      # Fetches projects from the connected ticketing tool.
-      def projects(params = {})
-        response = connection.get('ticketing/projects') do |req|
-          req.params = params
-        end
-
-        raise "Failed to fetch ticketing/projects: #{response.status}" unless response.success?
-
-        response.body
-      end
-
-      private
-
-      def blank?(value)
-        value.nil? || value.to_s.empty?
-      end
-    end
-  end
-end