basecamp-sdk 0.6.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da0e2d03c80b5801b886da56a59535f99cb521bd8233a146720ee117f76954b8
-  data.tar.gz: 4a3ea1075d88cac04a7dcc796f3c21d235aaffbb9d036be088321746c435c012
+  metadata.gz: '08447be78a091d1fd44c4ca85addf5d7f262f383e5d085d6765199362323d3de'
+  data.tar.gz: 538782581af8739afa7046e204b628fdbb6ed96f2822b92806b669c63b302708
 SHA512:
-  metadata.gz: e5d5298402d8239d525cff7aeac7815254cb7a1a3a967ed6f29fe9fea581432f0c2e7b272edc52a866b457ec988afc11f3ff6dbb48977b5e2ac716af8bbdb46a
-  data.tar.gz: f37ba99c63d4fb9836fe9fc5e6e717e0166f97892069da141f2be746ac95c8e15629319fb1deb4c23cdd4a7ee30d1ac84a83bf183e19930c9d394e47995704e6
+  metadata.gz: 90a91f187db4d1c0213169fba7c033a3da6f7efc5e2ef71c25318e1cbef39e2d3b7383477fd804257f7148ea44625f068658a1b1d6339585cda73a2a7f34a798
+  data.tar.gz: 052e7117c71e54bd7a415266b444e48e2344bc08b16475841e43934bdb7257c51cd283de7806f9b7893210611a778d36be3053dc3d5bee689f5107677e6cbc91

data/lib/basecamp/client.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+
 module Basecamp
   # Main client for the Basecamp API.
   #
@@ -188,6 +189,16 @@ module Basecamp
       @parent.http.post_raw(account_path(path), body: body, content_type: content_type)
     end
 
+    # Performs a PUT request with raw binary data scoped to this account.
+    # Used for multipart uploads (e.g., account logo).
+    # @param path [String] URL path (without account prefix)
+    # @param body [String, IO] raw binary data
+    # @param content_type [String] MIME content type
+    # @return [Response]
+    def put_raw(path, body:, content_type:)
+      @parent.http.put_raw(account_path(path), body: body, content_type: content_type)
+    end
+
     # Fetches all pages of a paginated resource.
     # @param path [String] URL path (without account prefix)
     # @param params [Hash] query parameters
@@ -320,6 +331,11 @@ module Basecamp
       service(:todosets) { Services::TodosetsService.new(self) }
     end
 
+    # @return [Services::HillChartsService]
+    def hill_charts
+      service(:hill_charts) { Services::HillChartsService.new(self) }
+    end
+
     # @return [Services::TodolistsService]
     def todolists
       service(:todolists) { Services::TodolistsService.new(self) }
@@ -500,6 +516,26 @@ module Basecamp
       service(:boosts) { Services::BoostsService.new(self) }
     end
 
+    # @return [Services::AccountService]
+    def account
+      service(:account) { Services::AccountService.new(self) }
+    end
+
+    # @return [Services::GaugesService]
+    def gauges
+      service(:gauges) { Services::GaugesService.new(self) }
+    end
+
+    # @return [Services::MyAssignmentsService]
+    def my_assignments
+      service(:my_assignments) { Services::MyAssignmentsService.new(self) }
+    end
+
+    # @return [Services::MyNotificationsService]
+    def my_notifications
+      service(:my_notifications) { Services::MyNotificationsService.new(self) }
+    end
+
     # @!endgroup
 
     private

data/lib/basecamp/generated/metadata.json

@@ -1,8 +1,61 @@
 {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-03-16T01:24:22Z",
+  "generated": "2026-03-25T06:39:18Z",
   "operations": {
+    "GetAccount": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "UpdateAccountLogo": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "RemoveAccountLogo": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "UpdateAccountName": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "CreateAttachment": {
       "retry": {
         "maxAttempts": 3,
@@ -750,6 +803,45 @@
         "natural": true
       }
     },
+    "GetGaugeNeedle": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "UpdateGaugeNeedle": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "DestroyGaugeNeedle": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "GetForward": {
       "retry": {
         "maxAttempts": 3,
@@ -826,6 +918,17 @@
         "maxPageSize": 50
       }
     },
+    "ListLineupMarkers": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "CreateLineupMarker": {
       "retry": {
         "maxAttempts": 2,
@@ -928,6 +1031,64 @@
         "natural": true
       }
     },
+    "GetMyAssignments": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "GetMyCompletedAssignments": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "GetMyDueAssignments": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "GetMyPreferences": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "UpdateMyPreferences": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "GetMyProfile": {
       "retry": {
         "maxAttempts": 3,
@@ -939,6 +1100,20 @@
         ]
       }
     },
+    "UpdateMyProfile": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "GetQuestionReminders": {
       "retry": {
         "maxAttempts": 3,
@@ -954,6 +1129,31 @@
         "maxPageSize": 50
       }
     },
+    "GetMyNotifications": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "MarkAsRead": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "ListPeople": {
       "retry": {
         "maxAttempts": 3,
@@ -981,6 +1181,42 @@
         ]
       }
     },
+    "GetOutOfOffice": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "EnableOutOfOffice": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "DisableOutOfOffice": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "ListProjects": {
       "retry": {
         "maxAttempts": 3,
@@ -1063,6 +1299,47 @@
         "natural": true
       }
     },
+    "ToggleGauge": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "ListGaugeNeedles": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
+    "CreateGaugeNeedle": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "ListProjectPeople": {
       "retry": {
         "maxAttempts": 3,
@@ -1617,6 +1894,22 @@
         "natural": true
       }
     },
+    "ListGauges": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
     "GetProgressReport": {
       "retry": {
         "maxAttempts": 3,
@@ -2117,6 +2410,31 @@
         ]
       }
     },
+    "GetHillChart": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "UpdateHillChartSettings": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "ListTodolists": {
       "retry": {
         "maxAttempts": 3,

data/lib/basecamp/generated/services/account_service.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for Account operations
+    #
+    # @generated from OpenAPI spec
+    class AccountService < BaseService
+
+      # Get the account for the current access token
+      # @return [Hash] response data
+      def get_account()
+        with_operation(service: "account", operation: "get_account", is_mutation: false) do
+          http_get("/account.json").json
+        end
+      end
+
+      # Upload or replace the account logo.
+      # @param io [IO, String] File data to upload (IO object or string)
+      # @param filename [String] Display name for the uploaded file
+      # @param content_type [String] MIME type of the file (e.g., "image/png")
+      # @return [void]
+      def update_account_logo(io:, filename:, content_type:)
+        with_operation(service: "account", operation: "update_account_logo", is_mutation: true) do
+          http_put_multipart("/account/logo.json", io: io, filename: filename, content_type: content_type, field: "logo")
+          nil
+        end
+      end
+
+      # Remove the account logo. Only administrators and account owners can use this endpoint.
+      # @return [void]
+      def remove_account_logo()
+        with_operation(service: "account", operation: "remove_account_logo", is_mutation: true) do
+          http_delete("/account/logo.json")
+          nil
+        end
+      end
+
+      # Rename the current account. Only account owners can use this endpoint.
+      # @param name [String] name
+      # @return [Hash] response data
+      def update_account_name(name:)
+        with_operation(service: "account", operation: "update_account_name", is_mutation: true) do
+          http_put("/account/name.json", body: compact_params(name: name)).json
+        end
+      end
+    end
+  end
+end

data/lib/basecamp/generated/services/base_service.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "cgi/escape"
+require "securerandom"
 
 module Basecamp
   module Services
@@ -162,12 +163,43 @@ module Basecamp
       #   @see AccountClient#post_raw
       # @!method paginate(path, params: {}, &block)
       #   @see AccountClient#paginate
-      %i[get post put delete post_raw].each do |method|
+      %i[get post put delete post_raw put_raw].each do |method|
         define_method(:"http_#{method}") do |*args, **kwargs, &block|
           @client.public_send(method, *args, **kwargs, &block)
         end
       end
 
+      # Upload a file as multipart/form-data.
+      # @param path [String] API path
+      # @param io [IO, String] file data
+      # @param filename [String] display filename
+      # @param content_type [String] MIME type
+      # @param field [String] form field name
+      def http_put_multipart(path, io:, filename:, content_type:, field: "file")
+        boundary = "BasecampSDK#{SecureRandom.hex(16)}"
+        body = build_multipart_body(boundary: boundary, field: field, io: io, \
+          filename: filename, content_type: content_type)
+        http_put_raw(path, body: body, content_type: "multipart/form-data; boundary=#{boundary}")
+        nil
+      end
+
+      private
+
+      def build_multipart_body(boundary:, field:, io:, filename:, content_type:)
+        data = io.respond_to?(:read) ? io.read : io.to_s
+        safe_filename = filename.tr("\r\n", "").gsub("\\", "\\\\").gsub('"', '\\"')
+        safe_content_type = content_type.tr("\r\n", "")
+        body = "".b
+        body << "--#{boundary}\r\n"
+        body << "Content-Disposition: form-data; name=\"#{field}\"; filename=\"#{safe_filename}\"\r\n"
+        body << "Content-Type: #{safe_content_type}\r\n"
+        body << "\r\n"
+        body << data
+        body << "\r\n"
+        body << "--#{boundary}--\r\n"
+        body.force_encoding(Encoding::BINARY)
+      end
+
       # Paginate doesn't conflict with service methods, keep as-is
       def paginate(...)
         @client.paginate(...)

data/lib/basecamp/generated/services/campfires_service.rb

@@ -81,10 +81,13 @@ module Basecamp
 
       # List all lines (messages) in a campfire
       # @param campfire_id [Integer] campfire id ID
+      # @param sort [String, nil] created_at|updated_at
+      # @param direction [String, nil] asc|desc
       # @return [Enumerator<Hash>] paginated results
-      def list_lines(campfire_id:)
+      def list_lines(campfire_id:, sort: nil, direction: nil)
         wrap_paginated(service: "campfires", operation: "list_lines", is_mutation: false, resource_id: campfire_id) do
-          paginate("/chats/#{campfire_id}/lines.json")
+          params = compact_params(sort: sort, direction: direction)
+          paginate("/chats/#{campfire_id}/lines.json", params: params)
         end
       end
 
@@ -122,10 +125,13 @@ module Basecamp
 
       # List uploaded files in a campfire
       # @param campfire_id [Integer] campfire id ID
+      # @param sort [String, nil] created_at|updated_at
+      # @param direction [String, nil] asc|desc
       # @return [Enumerator<Hash>] paginated results
-      def list_uploads(campfire_id:)
+      def list_uploads(campfire_id:, sort: nil, direction: nil)
         wrap_paginated(service: "campfires", operation: "list_uploads", is_mutation: false, resource_id: campfire_id) do
-          paginate("/chats/#{campfire_id}/uploads.json")
+          params = compact_params(sort: sort, direction: direction)
+          paginate("/chats/#{campfire_id}/uploads.json", params: params)
         end
       end
 

data/lib/basecamp/generated/services/cards_service.rb

@@ -32,10 +32,11 @@ module Basecamp
       # Move a card to a different column
       # @param card_id [Integer] card id ID
       # @param column_id [Integer] column id
+      # @param position [Integer, nil] 1-indexed position within the destination column. Defaults to 1 (top).
       # @return [void]
-      def move(card_id:, column_id:)
+      def move(card_id:, column_id:, position: nil)
         with_operation(service: "cards", operation: "move", is_mutation: true, resource_id: card_id) do
-          http_post("/card_tables/cards/#{card_id}/moves.json", body: compact_params(column_id: column_id))
+          http_post("/card_tables/cards/#{card_id}/moves.json", body: compact_params(column_id: column_id, position: position))
           nil
         end
       end

data/lib/basecamp/generated/services/checkins_service.rb

@@ -27,10 +27,11 @@ module Basecamp
       # Update an existing answer
       # @param answer_id [Integer] answer id ID
       # @param content [String] content
+      # @param group_on [String, nil] group on (YYYY-MM-DD)
       # @return [void]
-      def update_answer(answer_id:, content:)
+      def update_answer(answer_id:, content:, group_on: nil)
         with_operation(service: "checkins", operation: "update_answer", is_mutation: true, resource_id: answer_id) do
-          http_put("/question_answers/#{answer_id}", body: compact_params(content: content))
+          http_put("/question_answers/#{answer_id}", body: compact_params(content: content, group_on: group_on))
           nil
         end
       end

data/lib/basecamp/generated/services/client_approvals_service.rb

@@ -8,10 +8,13 @@ module Basecamp
     class ClientApprovalsService < BaseService
 
       # List all client approvals in a project
+      # @param sort [String, nil] created_at|updated_at
+      # @param direction [String, nil] asc|desc
       # @return [Enumerator<Hash>] paginated results
-      def list()
+      def list(sort: nil, direction: nil)
         wrap_paginated(service: "clientapprovals", operation: "list", is_mutation: false) do
-          paginate("/client/approvals.json")
+          params = compact_params(sort: sort, direction: direction)
+          paginate("/client/approvals.json", params: params)
         end
       end
 

data/lib/basecamp/generated/services/client_correspondences_service.rb

@@ -8,10 +8,13 @@ module Basecamp
     class ClientCorrespondencesService < BaseService
 
       # List all client correspondences in a project
+      # @param sort [String, nil] created_at|updated_at
+      # @param direction [String, nil] asc|desc
       # @return [Enumerator<Hash>] paginated results
-      def list()
+      def list(sort: nil, direction: nil)
         wrap_paginated(service: "clientcorrespondences", operation: "list", is_mutation: false) do
-          paginate("/client/correspondences.json")
+          params = compact_params(sort: sort, direction: direction)
+          paginate("/client/correspondences.json", params: params)
         end
       end
 

data/lib/basecamp/generated/services/forwards_service.rb

@@ -56,10 +56,13 @@ module Basecamp
 
       # List all forwards in an inbox
       # @param inbox_id [Integer] inbox id ID
+      # @param sort [String, nil] created_at|updated_at
+      # @param direction [String, nil] asc|desc
       # @return [Enumerator<Hash>] paginated results
-      def list(inbox_id:)
+      def list(inbox_id:, sort: nil, direction: nil)
         wrap_paginated(service: "forwards", operation: "list", is_mutation: false, resource_id: inbox_id) do
-          paginate("/inboxes/#{inbox_id}/forwards.json")
+          params = compact_params(sort: sort, direction: direction)
+          paginate("/inboxes/#{inbox_id}/forwards.json", params: params)
         end
       end
     end