basecamp-sdk 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06b1a1a19b501f386b63739724bb50b0f1d778660d2765f04d2c6a0d2214ef14
-  data.tar.gz: 3c2b5c8409d5a334eabb01b668e430510ad79b93cefc5ead3c5475f4b8f5d661
+  metadata.gz: b2b13ea2c32e1d4bf22a04af06e8c94d039e7698643a7aa7d9e0813f1526db2d
+  data.tar.gz: 942a8f09b4950764aa132ebd52a195d9d0eebb27b93656fb542e7e52b20ae1af
 SHA512:
-  metadata.gz: 0d9134c7b9996490c035fccc0c949acd1c05faff5c52b40aa5f30ab913456c10701a8742b74df33aea35539d197dd8c4932df3a1305d73db3efe2ac3de7bfa34
-  data.tar.gz: 3a4c47cb7196bd642f1c0863d25ff02fcf8ec607e102a6ce16cafe54aa5a74ef6290561c1897e365ff848e77911bdf8d7b3d31d85395adc4ba0b0753ba21d641
+  metadata.gz: '081775bc028c20205c904d026ab9f79bf077e7cde1d1bf5dd074b0e641fedf2ac47ebe3ca3cd6860f5bed05ad92d672abcaaf0332ec0f9aa94327ebc4cfcb130'
+  data.tar.gz: ffee6cf6e25a9ad523628b5d5f9da23f15460c3b01cd03dd8ab5df472942826e05d1a40afc09fc6cec9acaf9a3b2329c468f94b69a3ee4f95e2a784d94eb2775

data/README.md

@@ -42,7 +42,6 @@ project = account.projects.get(project_id: 12345)
 
 # Create a todo
 todo = account.todos.create(
-  project_id: 12345,
   todolist_id: 67890,
   content: "Review PR",
   due_on: "2024-12-31"
@@ -57,7 +56,7 @@ todo = account.todos.create(
 config = Basecamp::Config.new(
   base_url: "https://3.basecampapi.com",  # Default
   timeout: 30,                             # Request timeout in seconds
-  max_retries: 3,                          # Max retry attempts for GET requests
+  max_retries: 3,                          # Total request attempts for GET requests (including the initial request)
   base_delay: 1.0,                         # Base delay for exponential backoff
   max_pages: 10_000                         # Max pages for pagination
 )
@@ -72,7 +71,7 @@ client = Basecamp::Client.new(config: config, token_provider: token_provider)
 |--------|---------|-------------|
 | `base_url` | `https://3.basecampapi.com` | Basecamp API base URL |
 | `timeout` | `30` | HTTP request timeout (seconds) |
-| `max_retries` | `3` | Maximum retry attempts for GET requests |
+| `max_retries` | `3` | Total request attempts for GET requests (including the initial request) |
 | `base_delay` | `1.0` | Base delay for exponential backoff (seconds) |
 | `max_jitter` | `0.1` | Maximum random jitter added to delays |
 | `max_pages` | `10_000` | Maximum pages to fetch during pagination |
@@ -133,6 +132,99 @@ if token.expired?
 end
 ```
 
+### Device Authorization Grant (RFC 8628)
+
+For input-constrained clients (CLIs, TVs) that can't host a redirect URI, the
+device flow trades a redirect for a user-entered code. Basecamp pre-registers the
+public `basecamp-cli` client (`token_endpoint_auth_method: none`, no secret); an
+omitted scope defaults to `read` — prefer pinning it explicitly with
+`scope: "read"`. Pass bare origins everywhere (no trailing slash): binding is
+code-point exact — a trailing-slash `expected_issuer` raises a **hard**
+`expected_issuer_unavailable`, while a trailing-slash resource origin breaks
+the hop-1 binding and silently soft-falls back to Launchpad.
+
+```ruby
+# The device grant runs against an ALREADY-SELECTED config whose issuer advertises
+# a device_authorization_endpoint. Resolve one with resource-first discovery —
+# NOT discover_launchpad: Launchpad advertises no device endpoint, so the
+# capability guard would reject it.
+result = Basecamp::Oauth.discover_from_resource("https://3.basecampapi.com")
+raise "device login is not available for this resource" unless result.selected?
+config = result.config
+
+# One call runs the whole grant against the SELECTED config: it guards
+# capability, requests a device/user code, shows it via the display hook, then
+# polls the token endpoint until the user approves.
+token = Basecamp::Oauth.perform_device_login(
+  config: config,
+  client_id: "basecamp-cli",
+  display: ->(auth) do
+    puts "Visit #{auth.verification_uri} and enter code: #{auth.user_code}"
+    puts "Or open: #{auth.verification_uri_complete}" if auth.verification_uri_complete
+  end
+)
+
+client = Basecamp.client(access_token: token.access_token)
+
+# BC5 device logins as basecamp-cli mint MULTI-ACCOUNT refresh tokens: the
+# token carries an RFC 8707 resource indicator (token.resource,
+# "urn:bc:account:<id>"), and refreshing without echoing it is rejected
+# (400 invalid_request). Persist token.resource alongside the tokens and
+# echo it on refresh:
+# A device-token response MAY omit refresh_token — guard it: without one,
+# refreshing is impossible and the user must re-run the device login.
+if token.expired? && token.refresh_token
+  fresh = Basecamp::Oauth.refresh_token(
+    token_endpoint: config.token_endpoint,
+    refresh_token: token.refresh_token,
+    client_id: "basecamp-cli",   # public client — no secret
+    resource: token.resource
+  )
+  # A refresh response MAY omit resource (the binding is unchanged) — persist
+  # `fresh.resource || token.resource` so the next refresh still echoes it.
+end
+```
+
+The capability guard requires BOTH `config.device_authorization_endpoint` AND the
+exact grant-type URN `urn:ietf:params:oauth:grant-type:device_code` in
+`config.grant_types_supported` — servers advertise the full URN, so checking for
+a bare `device_code` entry would wrongly conclude the flow is unavailable;
+otherwise it raises
+`Basecamp::Oauth::DeviceFlowError` with `reason: :unavailable` before any request
+is issued. The two lower-level steps are also exposed directly:
+
+```ruby
+auth = Basecamp::Oauth.request_device_authorization(
+  device_authorization_endpoint: config.device_authorization_endpoint,
+  client_id: "basecamp-cli"
+)
+
+token = Basecamp::Oauth.poll_device_token(
+  token_endpoint: config.token_endpoint,
+  client_id: "basecamp-cli",
+  device_code: auth.device_code,
+  interval: auth.interval,
+  expires_in: auth.expires_in
+)
+```
+
+The polling loop waits at least `interval` seconds between polls against a
+**monotonic** deadline, sustains a `slow_down` bump (+5s for every later poll),
+and backs off exponentially on connection timeouts. A terminal outcome raises
+`DeviceFlowError` carrying a `reason` whose parent `type` is derived from it:
+
+| `reason` | `type` | Meaning |
+|---|---|---|
+| `:access_denied` | `auth` | The user declined the request |
+| `:expired` | `auth` | The code expired before approval |
+| `:transport` | `network` (retryable) | A network failure ended the flow |
+| `:unavailable` | `validation` | The config can't do device flow |
+| `:cancelled` | `usage` | The caller cancelled the flow |
+
+`poll_device_token` and `perform_device_login` accept injectable `clock`,
+`sleeper`, and `cancelled` callables — pass a `cancelled` probe (e.g. one that
+checks a signal set by SIGINT) to abort a pending login cleanly.
+
 ### Resource-First Discovery (RFC 9728 + RFC 8414)
 
 BC5's Authorization Server (AS) metadata lives only at the canonical issuer (the
@@ -179,7 +271,7 @@ aborts before an oversized body is buffered.
 
 ## Services
 
-The SDK provides 45 account-scoped services. The table below covers the common ones; see `lib/basecamp/generated/services/` for the authoritative, complete set:
+The SDK provides 46 account-scoped services. The table below covers the common ones; see `lib/basecamp/generated/services/` for the authoritative, complete set:
 
 | Service | Description |
 |---------|-------------|
@@ -260,13 +352,15 @@ result = account.download_url(url)
 
 ## Retry Behavior
 
-GET requests automatically retry on transient failures with exponential backoff:
-
-- **Retryable errors**: 429 (rate limit), 502, 503, 504 (gateway errors)
-- **Backoff**: Exponential with jitter (1s, 2s, 4s...)
-- **Rate limits**: Respects `Retry-After` header
+Only plain GET requests retry — automatically, with exponential backoff. Mutation operations (POST, PUT, DELETE) do **not** retry to prevent data duplication, and the raw upload and download paths skip the retry loop entirely (the upload path is strictly one request; the download hop keeps only the one-shot 401 replay below).
 
-Mutation operations (POST, PUT, DELETE) do **not** retry to prevent data duplication.
+- **Which errors**: Retry keys off the error's `retryable?` classification, not a declared status list — 429 (rate limit), 500, 502, 503, 504, and any other 5xx all retry, as does `NetworkError` (connection failures, including DNS and connect-phase timeouts). Read timeouts are the exception: Faraday surfaces them as a status-less `ApiError` with `retryable? == false`, so a GET that times out mid-response fails on the first attempt. 400, 401, 403, 404, and 422 never retry.
+- **`max_retries`**: Total request attempts for GET requests, including the initial request — the default `3` means one initial attempt plus two retries. **`max_retries: 0` sends zero requests** and raises `Basecamp::ApiError` (`"Request failed after 0 attempts"`).
+- **Backoff**: Exponential with jitter — `base_delay * 2^(attempt - 1) + rand * max_jitter` — uncapped, bounded in practice by the attempt budget.
+- **Rate limits**: A 429's `Retry-After` header overrides the calculated backoff. Only 429 carries it: 5xx and network errors always use the exponential backoff.
+- **401 responses**: With a refresh-capable token provider, the SDK refreshes the token and replays the request **once** — for all methods, including mutations — outside the `max_retries` budget. A second 401 is surfaced. The raw upload path has no 401 replay.
+- **Per-operation metadata**: The retry policy operations declare (`retry_on` statuses, per-operation `max`) is inert in Ruby — every API GET issued through the client, including the Launchpad authorization fetch, rides the same classification-based loop bounded by `config.max_retries` alone. (The download flow's redirect hop and OAuth discovery use their own single-attempt transports.)
+- **`retryable?`**: Unlike SDKs where the error classification is only a hint for your own code, in Ruby an error's `retryable?` (and `retry_after`) is exactly what the transport acts on for GET requests.
 
 ## Error Handling
 
@@ -335,6 +429,8 @@ client = Basecamp::Client.new(
 | `BASECAMP_TOKEN` | OAuth access token |
 | `BASECAMP_ACCOUNT_ID` | Account ID |
 | `BASECAMP_BASE_URL` | API base URL (default: `https://3.basecampapi.com`) |
+| `BASECAMP_TIMEOUT` | Request timeout in seconds (default: `30`) |
+| `BASECAMP_MAX_RETRIES` | Total request attempts for GET requests, including the initial request (default: `3`) |
 
 ## Development
 

data/lib/basecamp/client.rb

@@ -152,8 +152,8 @@ module Basecamp
     # @param path [String] URL path (without account prefix)
     # @param params [Hash] query parameters
     # @return [Response]
-    def get(path, params: {})
-      @parent.http.get(account_path(path), params: params)
+    def get(path, params: {}, operation: nil)
+      @parent.http.get(account_path(path), params: params, operation: operation)
     end
 
     # Performs a POST request scoped to this account.
@@ -204,8 +204,8 @@ module Basecamp
     # @param params [Hash] query parameters
     # @yield [Hash] each item from the response
     # @return [Enumerator] if no block given
-    def paginate(path, params: {}, &)
-      @parent.http.paginate(account_path(path), params: params, &)
+    def paginate(path, params: {}, operation: nil, &)
+      @parent.http.paginate(account_path(path), params: params, operation: operation, &)
     end
 
     # Fetches all pages of a paginated resource, extracting items from a key.
@@ -215,8 +215,8 @@ module Basecamp
     # @param params [Hash] query parameters
     # @yield [Hash] each item from the response
     # @return [Enumerator] if no block given
-    def paginate_key(path, key:, params: {}, &)
-      @parent.http.paginate_key(account_path(path), key: key, params: params, &)
+    def paginate_key(path, key:, params: {}, operation: nil, &)
+      @parent.http.paginate_key(account_path(path), key: key, params: params, operation: operation, &)
     end
 
     # Fetches a wrapped paginated resource, returning wrapper fields + lazy paginated items.
@@ -224,8 +224,8 @@ module Basecamp
     # @param key [String] the key containing the array of paginated items
     # @param params [Hash] query parameters
     # @return [Hash] wrapper fields merged with key => Enumerator of all items
-    def paginate_wrapped(path, key:, params: {})
-      @parent.http.paginate_wrapped(account_path(path), key: key, params: params)
+    def paginate_wrapped(path, key:, params: {}, operation: nil)
+      @parent.http.paginate_wrapped(account_path(path), key: key, params: params, operation: operation)
     end
 
     # Downloads file content from any API-routable download URL.

data/lib/basecamp/config.rb

@@ -24,7 +24,8 @@ module Basecamp
     # @return [Integer] request timeout in seconds
     attr_accessor :timeout
 
-    # @return [Integer] maximum retry attempts for GET requests
+    # @return [Integer] total request attempts for GET requests, including the
+    #   initial request (0 sends no requests at all and raises)
     attr_accessor :max_retries
 
     # @return [Float] initial backoff delay in seconds
@@ -48,7 +49,7 @@ module Basecamp
     #
     # @param base_url [String] API base URL
     # @param timeout [Integer] request timeout in seconds
-    # @param max_retries [Integer] maximum retry attempts
+    # @param max_retries [Integer] total request attempts for GET requests, including the initial request
     # @param base_delay [Float] initial backoff delay
     # @param max_jitter [Float] maximum jitter
     # @param max_pages [Integer] maximum pages to fetch
@@ -78,7 +79,7 @@ module Basecamp
     # Environment variables:
     # - BASECAMP_BASE_URL: API base URL
     # - BASECAMP_TIMEOUT: Request timeout in seconds
-    # - BASECAMP_MAX_RETRIES: Maximum retry attempts
+    # - BASECAMP_MAX_RETRIES: Total request attempts for GET requests, including the initial request
     #
     # @return [Config]
     def self.from_env

data/lib/basecamp/generated/metadata.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-07-28T21:34:14Z",
+  "generated": "2026-07-31T06:58:29Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -67,22 +67,6 @@
         ]
       }
     },
-    "GetEverythingBoosts": {
-      "retry": {
-        "maxAttempts": 3,
-        "baseDelayMs": 1000,
-        "backoff": "exponential",
-        "retryOn": [
-          429,
-          503
-        ]
-      },
-      "pagination": {
-        "style": "link",
-        "totalCountHeader": "X-Total-Count",
-        "maxPageSize": 50
-      }
-    },
     "GetBoost": {
       "retry": {
         "maxAttempts": 3,
@@ -131,6 +115,9 @@
           429,
           503
         ]
+      },
+      "idempotent": {
+        "natural": true
       }
     },
     "DisableCardColumnOnHold": {
@@ -2054,6 +2041,9 @@
           429,
           503
         ]
+      },
+      "idempotent": {
+        "natural": true
       }
     },
     "UpdateSubscription": {

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

@@ -11,7 +11,7 @@ module Basecamp
       # @return [Hash] response data
       def get_account()
         with_operation(service: "account", operation: "get_account", is_mutation: false) do
-          http_get("/account.json").json
+          http_get("/account.json", operation: "GetAccount").json
         end
       end
 

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

@@ -11,7 +11,7 @@ module Basecamp
       # @return [Array<Hash>] response data
       def list_lineup_markers()
         with_operation(service: "automation", operation: "list_lineup_markers", is_mutation: false) do
-          http_get("/lineup/markers.json").json
+          http_get("/lineup/markers.json", operation: "ListLineupMarkers").json
         end
       end
     end

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

@@ -12,7 +12,7 @@ module Basecamp
       # @return [Hash] response data
       def get_boost(boost_id:)
         with_operation(service: "boosts", operation: "get_boost", is_mutation: false, resource_id: boost_id) do
-          http_get("/boosts/#{boost_id}").json
+          http_get("/boosts/#{boost_id}", operation: "GetBoost").json
         end
       end
 
@@ -31,7 +31,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list_recording_boosts(recording_id:)
         wrap_paginated(service: "boosts", operation: "list_recording_boosts", is_mutation: false, resource_id: recording_id) do
-          paginate("/recordings/#{recording_id}/boosts.json")
+          paginate("/recordings/#{recording_id}/boosts.json", operation: "ListRecordingBoosts")
         end
       end
 
@@ -51,7 +51,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list_event_boosts(recording_id:, event_id:)
         wrap_paginated(service: "boosts", operation: "list_event_boosts", is_mutation: false, resource_id: event_id) do
-          paginate("/recordings/#{recording_id}/events/#{event_id}/boosts.json")
+          paginate("/recordings/#{recording_id}/events/#{event_id}/boosts.json", operation: "ListEventBoosts")
         end
       end
 

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

@@ -13,7 +13,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list()
         wrap_paginated(service: "campfires", operation: "list", is_mutation: false) do
-          paginate("/chats.json")
+          paginate("/chats.json", operation: "ListCampfires")
         end
       end
 
@@ -22,7 +22,7 @@ module Basecamp
       # @return [Hash] response data
       def get(campfire_id:)
         with_operation(service: "campfires", operation: "get", is_mutation: false, resource_id: campfire_id) do
-          http_get("/chats/#{campfire_id}").json
+          http_get("/chats/#{campfire_id}", operation: "GetCampfire").json
         end
       end
 
@@ -31,7 +31,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list_chatbots(campfire_id:)
         wrap_paginated(service: "campfires", operation: "list_chatbots", is_mutation: false, resource_id: campfire_id) do
-          paginate("/chats/#{campfire_id}/integrations.json")
+          paginate("/chats/#{campfire_id}/integrations.json", operation: "ListChatbots")
         end
       end
 
@@ -52,7 +52,7 @@ module Basecamp
       # @return [Hash] response data
       def get_chatbot(campfire_id:, chatbot_id:)
         with_operation(service: "campfires", operation: "get_chatbot", is_mutation: false, resource_id: chatbot_id) do
-          http_get("/chats/#{campfire_id}/integrations/#{chatbot_id}").json
+          http_get("/chats/#{campfire_id}/integrations/#{chatbot_id}", operation: "GetChatbot").json
         end
       end
 
@@ -87,7 +87,7 @@ module Basecamp
       def list_lines(campfire_id:, sort: nil, direction: nil)
         wrap_paginated(service: "campfires", operation: "list_lines", is_mutation: false, resource_id: campfire_id) do
           params = compact_query_params(sort: sort, direction: direction)
-          paginate("/chats/#{campfire_id}/lines.json", params: params)
+          paginate("/chats/#{campfire_id}/lines.json", params: params, operation: "ListCampfireLines")
         end
       end
 
@@ -108,7 +108,7 @@ module Basecamp
       # @return [Hash] response data
       def get_line(campfire_id:, line_id:)
         with_operation(service: "campfires", operation: "get_line", is_mutation: false, resource_id: line_id) do
-          http_get("/chats/#{campfire_id}/lines/#{line_id}").json
+          http_get("/chats/#{campfire_id}/lines/#{line_id}", operation: "GetCampfireLine").json
         end
       end
 
@@ -143,7 +143,7 @@ module Basecamp
       def list_uploads(campfire_id:, sort: nil, direction: nil)
         wrap_paginated(service: "campfires", operation: "list_uploads", is_mutation: false, resource_id: campfire_id) do
           params = compact_query_params(sort: sort, direction: direction)
-          paginate("/chats/#{campfire_id}/uploads.json", params: params)
+          paginate("/chats/#{campfire_id}/uploads.json", params: params, operation: "ListCampfireUploads")
         end
       end
 

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

@@ -43,7 +43,7 @@ module Basecamp
       # @return [Hash] response data
       def get(column_id:)
         with_operation(service: "cardcolumns", operation: "get", is_mutation: false, resource_id: column_id) do
-          http_get("/card_tables/columns/#{column_id}").json
+          http_get("/card_tables/columns/#{column_id}", operation: "GetCardColumn").json
         end
       end
 

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

@@ -36,7 +36,7 @@ module Basecamp
       # @return [Hash] response data
       def get(step_id:)
         with_operation(service: "cardsteps", operation: "get", is_mutation: false, resource_id: step_id) do
-          http_get("/card_tables/steps/#{step_id}").json
+          http_get("/card_tables/steps/#{step_id}", operation: "GetCardStep").json
         end
       end
 

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

@@ -12,7 +12,7 @@ module Basecamp
       # @return [Hash] response data
       def get(card_table_id:)
         with_operation(service: "cardtables", operation: "get", is_mutation: false, resource_id: card_table_id) do
-          http_get("/card_tables/#{card_table_id}").json
+          http_get("/card_tables/#{card_table_id}", operation: "GetCardTable").json
         end
       end
     end

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

@@ -12,7 +12,7 @@ module Basecamp
       # @return [Hash] response data
       def get(card_id:)
         with_operation(service: "cards", operation: "get", is_mutation: false, resource_id: card_id) do
-          http_get("/card_tables/cards/#{card_id}").json
+          http_get("/card_tables/cards/#{card_id}", operation: "GetCard").json
         end
       end
 
@@ -46,7 +46,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list(column_id:)
         wrap_paginated(service: "cards", operation: "list", is_mutation: false, resource_id: column_id) do
-          paginate("/card_tables/lists/#{column_id}/cards.json")
+          paginate("/card_tables/lists/#{column_id}/cards.json", operation: "ListCards")
         end
       end
 

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

@@ -11,7 +11,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def reminders()
         wrap_paginated(service: "checkins", operation: "reminders", is_mutation: false) do
-          paginate("/my/question_reminders.json")
+          paginate("/my/question_reminders.json", operation: "GetQuestionReminders")
         end
       end
 
@@ -20,7 +20,7 @@ module Basecamp
       # @return [Hash] response data
       def get_answer(answer_id:)
         with_operation(service: "checkins", operation: "get_answer", is_mutation: false, resource_id: answer_id) do
-          http_get("/question_answers/#{answer_id}").json
+          http_get("/question_answers/#{answer_id}", operation: "GetAnswer").json
         end
       end
 
@@ -41,7 +41,7 @@ module Basecamp
       # @return [Hash] response data
       def get_questionnaire(questionnaire_id:)
         with_operation(service: "checkins", operation: "get_questionnaire", is_mutation: false, resource_id: questionnaire_id) do
-          http_get("/questionnaires/#{questionnaire_id}").json
+          http_get("/questionnaires/#{questionnaire_id}", operation: "GetQuestionnaire").json
         end
       end
 
@@ -50,7 +50,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list_questions(questionnaire_id:)
         wrap_paginated(service: "checkins", operation: "list_questions", is_mutation: false, resource_id: questionnaire_id) do
-          paginate("/questionnaires/#{questionnaire_id}/questions.json")
+          paginate("/questionnaires/#{questionnaire_id}/questions.json", operation: "ListQuestions")
         end
       end
 
@@ -71,7 +71,7 @@ module Basecamp
       # @return [Hash] response data
       def get_question(question_id:)
         with_operation(service: "checkins", operation: "get_question", is_mutation: false, resource_id: question_id) do
-          http_get("/questions/#{question_id}").json
+          http_get("/questions/#{question_id}", operation: "GetQuestion").json
         end
       end
 
@@ -92,7 +92,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list_answers(question_id:)
         wrap_paginated(service: "checkins", operation: "list_answers", is_mutation: false, resource_id: question_id) do
-          paginate("/questions/#{question_id}/answers.json")
+          paginate("/questions/#{question_id}/answers.json", operation: "ListAnswers")
         end
       end
 
@@ -112,7 +112,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def answerers(question_id:)
         wrap_paginated(service: "checkins", operation: "answerers", is_mutation: false, resource_id: question_id) do
-          paginate("/questions/#{question_id}/answers/by.json")
+          paginate("/questions/#{question_id}/answers/by.json", operation: "ListQuestionAnswerers")
         end
       end
 
@@ -122,7 +122,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def by_person(question_id:, person_id:)
         wrap_paginated(service: "checkins", operation: "by_person", is_mutation: false, resource_id: person_id) do
-          paginate("/questions/#{question_id}/answers/by/#{person_id}")
+          paginate("/questions/#{question_id}/answers/by/#{person_id}", operation: "GetAnswersByPerson")
         end
       end
 

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

@@ -14,7 +14,7 @@ module Basecamp
       def list(sort: nil, direction: nil)
         wrap_paginated(service: "clientapprovals", operation: "list", is_mutation: false) do
           params = compact_query_params(sort: sort, direction: direction)
-          paginate("/client/approvals.json", params: params)
+          paginate("/client/approvals.json", params: params, operation: "ListClientApprovals")
         end
       end
 
@@ -23,7 +23,7 @@ module Basecamp
       # @return [Hash] response data
       def get(approval_id:)
         with_operation(service: "clientapprovals", operation: "get", is_mutation: false, resource_id: approval_id) do
-          http_get("/client/approvals/#{approval_id}").json
+          http_get("/client/approvals/#{approval_id}", operation: "GetClientApproval").json
         end
       end
     end

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

@@ -14,7 +14,7 @@ module Basecamp
       def list(sort: nil, direction: nil)
         wrap_paginated(service: "clientcorrespondences", operation: "list", is_mutation: false) do
           params = compact_query_params(sort: sort, direction: direction)
-          paginate("/client/correspondences.json", params: params)
+          paginate("/client/correspondences.json", params: params, operation: "ListClientCorrespondences")
         end
       end
 
@@ -23,7 +23,7 @@ module Basecamp
       # @return [Hash] response data
       def get(correspondence_id:)
         with_operation(service: "clientcorrespondences", operation: "get", is_mutation: false, resource_id: correspondence_id) do
-          http_get("/client/correspondences/#{correspondence_id}").json
+          http_get("/client/correspondences/#{correspondence_id}", operation: "GetClientCorrespondence").json
         end
       end
     end

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

@@ -12,7 +12,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list(recording_id:)
         wrap_paginated(service: "clientreplies", operation: "list", is_mutation: false, resource_id: recording_id) do
-          paginate("/client/recordings/#{recording_id}/replies.json")
+          paginate("/client/recordings/#{recording_id}/replies.json", operation: "ListClientReplies")
         end
       end
 
@@ -22,7 +22,7 @@ module Basecamp
       # @return [Hash] response data
       def get(recording_id:, reply_id:)
         with_operation(service: "clientreplies", operation: "get", is_mutation: false, resource_id: reply_id) do
-          http_get("/client/recordings/#{recording_id}/replies/#{reply_id}").json
+          http_get("/client/recordings/#{recording_id}/replies/#{reply_id}", operation: "GetClientReply").json
         end
       end
     end

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

@@ -12,7 +12,7 @@ module Basecamp
       # @return [Hash] response data
       def get(comment_id:)
         with_operation(service: "comments", operation: "get", is_mutation: false, resource_id: comment_id) do
-          http_get("/comments/#{comment_id}").json
+          http_get("/comments/#{comment_id}", operation: "GetComment").json
         end
       end
 
@@ -31,7 +31,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list(recording_id:)
         wrap_paginated(service: "comments", operation: "list", is_mutation: false, resource_id: recording_id) do
-          paginate("/recordings/#{recording_id}/comments.json")
+          paginate("/recordings/#{recording_id}/comments.json", operation: "ListComments")
         end
       end
 

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

@@ -12,7 +12,7 @@ module Basecamp
       # @return [Hash] response data
       def get(document_id:)
         with_operation(service: "documents", operation: "get", is_mutation: false, resource_id: document_id) do
-          http_get("/documents/#{document_id}").json
+          http_get("/documents/#{document_id}", operation: "GetDocument").json
         end
       end
 
@@ -32,7 +32,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list(vault_id:)
         wrap_paginated(service: "documents", operation: "list", is_mutation: false, resource_id: vault_id) do
-          paginate("/vaults/#{vault_id}/documents.json")
+          paginate("/vaults/#{vault_id}/documents.json", operation: "ListDocuments")
         end
       end
 

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

@@ -12,7 +12,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list(recording_id:)
         wrap_paginated(service: "events", operation: "list", is_mutation: false, resource_id: recording_id) do
-          paginate("/recordings/#{recording_id}/events.json")
+          paginate("/recordings/#{recording_id}/events.json", operation: "ListEvents")
         end
       end
     end