basecamp-sdk 0.15.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6c1f02712a441b2b7772199b8029904b0c254be6c9b687a94a8d957f7d8a066
-  data.tar.gz: f0750c8e75561aaa908630440f0b2c4276a54abb653418361cc4363883497d9a
+  metadata.gz: 6831e79b8c78f4ba54ee64287457227c5553fbd2837e71b09d022601084ac2af
+  data.tar.gz: 3dd5ac9aefd6f03e78fa9fa4c9833ac98d217a09a05ea129b8b2b6f3d7049939
 SHA512:
-  metadata.gz: a7d6ecde9f18d17b9baadc7b827b6d396c0f6e63ab304d93800ee2e35f3803af9d668965b5d5885a408d926e780700f7fe0320d68375924a6647cce2462eee20
-  data.tar.gz: a445a4123c2ebf596026035d347dbe99883b207a650003d2651f0dbc77eed9c0f4634703555e17af674aca87e015fdbe17f38a40e9370deff1b73a42cec6d042
+  metadata.gz: 007f77e92a111a5687b26740caedc75e71e640ddfc10a32057b39b1627ab7cedd2412faebc75647b26402551e7f235b4bf77743236e8ab9da5fc26e8b8286c0b
+  data.tar.gz: dff2430d3c5225c2ad563c0848d61d09a1da0620c58d93438947318f567b2f551548b5a899dfbadb55d14f84b495efb8982f786515c8fd934a885757b5f9db5e

data/lib/basecamp/api_error.rb

@@ -17,11 +17,12 @@ module Basecamp
     # Creates an ApiError from an HTTP status code.
     # @param status [Integer] HTTP status code
     # @param message [String, nil] optional error message
+    # @param hint [String, nil] optional hint (SPEC section 6 step 3)
     # @return [ApiError]
-    def self.from_status(status, message = nil)
+    def self.from_status(status, message = nil, hint: nil)
       message ||= "Request failed (HTTP #{status})"
       retryable = status >= 500 && status < 600
-      new(message, http_status: status, retryable: retryable)
+      new(message, http_status: status, hint: hint, retryable: retryable)
     end
   end
 end

data/lib/basecamp/client.rb

@@ -507,6 +507,11 @@ module Basecamp
       service(:bookmarks) { Services::BookmarksService.new(self) }
     end
 
+    # @return [Services::BubbleUpsService]
+    def bubble_ups
+      service(:bubble_ups) { Services::BubbleUpsService.new(self) }
+    end
+
     # @return [Services::FoldersService]
     def folders
       service(:folders) { Services::FoldersService.new(self) }
@@ -635,7 +640,16 @@ module Basecamp
         nil
       end
       unless uri.is_a?(URI::HTTP) && uri.host && !uri.host.empty?
-        raise ApiError.new("redirect to undialable download URL: #{Security.truncate(url)}")
+        # SPEC §9: the signed URL is a credential — render its origin alone,
+        # projected from the parse, or the fixed token when no complete origin
+        # exists. Truncating the whole URL kept a short query intact.
+        origin = if uri&.scheme && uri&.host && !uri.host.empty?
+          port = uri.port && uri.port != uri.default_port ? ":#{uri.port}" : ""
+          "#{uri.scheme}://#{uri.host}#{port}"
+        else
+          "unparsable"
+        end
+        raise ApiError.new("redirect to undialable download URL: #{origin}")
       end
 
       http_client = Net::HTTP.new(uri.host, uri.port)
@@ -652,8 +666,12 @@ module Basecamp
         # Redirect Policy"). Stated here so a move to a following client
         # (Faraday, Net::HTTP.get_response's callers) has to argue with it.
         response = http_client.request(request)
-      rescue StandardError => e
-        raise NetworkError.new("Download failed: #{e.message}", cause: e)
+      rescue StandardError
+        # SPEC §9: the transport error renders the signed URL, so neither its
+        # message nor the exception itself survives. cause: nil at the raise
+        # site — MRI sets the built-in cause at raise time past the class's
+        # stored cause: keyword (same pattern as oauth/exchange.rb).
+        raise NetworkError.new("Download failed"), cause: nil
       end
 
       # The exact set hop 1 dispatches on, not Net::HTTPRedirection — that

data/lib/basecamp/generated/metadata.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-08-12T19:58:36Z",
+  "generated": "2026-09-08T23:57:38Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -1576,6 +1576,17 @@
         "maxPageSize": 50
       }
     },
+    "ListRecentProjects": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "MarkAsRead": {
       "retry": {
         "maxAttempts": 2,
@@ -1735,6 +1746,34 @@
         "natural": true
       }
     },
+    "EnableProjectClients": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "DisableProjectClients": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "ToggleGauge": {
       "retry": {
         "maxAttempts": 2,
@@ -1792,6 +1831,19 @@
         "maxPageSize": 50
       }
     },
+    "UpdateProjectClientAccess": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "UpdateProjectAccess": {
       "retry": {
         "maxAttempts": 3,
@@ -1806,6 +1858,20 @@
         "natural": true
       }
     },
+    "RecordProjectVisit": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "UnarchiveProject": {
       "retry": {
         "maxAttempts": 3,
@@ -2144,6 +2210,34 @@
         ]
       }
     },
+    "CreateBubbleUp": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "DeleteBubbleUp": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "SetClientVisibility": {
       "retry": {
         "maxAttempts": 3,
@@ -2228,6 +2322,34 @@
         ]
       }
     },
+    "SpotlightRecording": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "UnspotlightRecording": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "UnarchiveRecording": {
       "retry": {
         "maxAttempts": 3,
@@ -2668,6 +2790,39 @@
         "natural": true
       }
     },
+    "GetTemplateLibrary": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "CreateTemplateLibraryCopy": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "GetTemplateLibraryCopy": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "ListTemplates": {
       "retry": {
         "maxAttempts": 3,

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for BubbleUps operations
+    #
+    # @generated from OpenAPI spec
+    class BubbleUpsService < BaseService
+
+      # Bubble up a recording for the current user, resurfacing it in the current
+      # @param recording_id [Integer] recording id ID
+      # @param at [String, nil] Timing for the bubble-up. `"now"` bubbles up immediately; a scheduling
+      #   keyword (`"today"`, `"tomorrow"`, `"weekend"`, `"next_week"`) or an ISO8601
+      #   date (e.g. `"2026-09-10"`) schedules it to resurface later. bc3 requires a
+      #   value — omitting `at` errors server-side (`Date.iso8601(nil)`) — so send
+      #   `"now"` for the immediate case.
+      # @return [void]
+      def create_bubble_up(recording_id:, at: nil)
+        with_operation(service: "bubbleups", operation: "create_bubble_up", is_mutation: true, resource_id: recording_id) do
+          http_post("/recordings/#{recording_id}/bubble_up.json", body: compact_params(at: at))
+          nil
+        end
+      end
+
+      # Remove the current user's bubble-up from a recording (returns 204 No Content).
+      # @param recording_id [Integer] recording id ID
+      # @return [void]
+      def delete_bubble_up(recording_id:)
+        with_operation(service: "bubbleups", operation: "delete_bubble_up", is_mutation: true, resource_id: recording_id) do
+          http_delete("/recordings/#{recording_id}/bubble_up.json")
+          nil
+        end
+      end
+    end
+  end
+end

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

@@ -107,6 +107,24 @@ module Basecamp
         end
       end
 
+      # Enable clients on a project so client users can be added to it
+      # @param project_id [Integer] project id ID
+      # @return [Hash] response data
+      def enable_project_clients(project_id:)
+        with_operation(service: "people", operation: "enable_project_clients", is_mutation: true, project_id: project_id) do
+          http_post("/projects/#{project_id}/client_enablement.json").json
+        end
+      end
+
+      # Disable clients on a project
+      # @param project_id [Integer] project id ID
+      # @return [Hash] response data
+      def disable_project_clients(project_id:)
+        with_operation(service: "people", operation: "disable_project_clients", is_mutation: true, project_id: project_id) do
+          http_delete("/projects/#{project_id}/client_enablement.json").json
+        end
+      end
+
       # List all active people on a project
       # @param project_id [Integer] project id ID
       # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
@@ -119,6 +137,18 @@ module Basecamp
         end
       end
 
+      # Update project client access (grant/revoke/create client users)
+      # @param project_id [Integer] project id ID
+      # @param grant [Array, nil] Existing client people IDs to add to the project.
+      # @param revoke [Array, nil] Client people IDs to remove from the project.
+      # @param create [Array, nil] New clients to invite by email.
+      # @return [Hash] response data
+      def update_project_client_access(project_id:, grant: nil, revoke: nil, create: nil)
+        with_operation(service: "people", operation: "update_project_client_access", is_mutation: true, project_id: project_id) do
+          http_put("/projects/#{project_id}/people/client_users.json", body: compact_params(grant: grant, revoke: revoke, create: create)).json
+        end
+      end
+
       # Update project access (grant/revoke/create people)
       # @param project_id [Integer] project id ID
       # @param grant [Array, nil] grant

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

@@ -7,6 +7,14 @@ module Basecamp
     # @generated from OpenAPI spec
     class ProjectsService < BaseService
 
+      # List the projects the current user has most recently visited, most recent visit first.
+      # @return [Array<Hash>] response data
+      def list_recent_projects()
+        with_operation(service: "projects", operation: "list_recent_projects", is_mutation: false) do
+          http_get("/my/recent_projects.json", operation: "ListRecentProjects").json
+        end
+      end
+
       # List projects (active by default; optionally archived/trashed)
       # @param status [String, nil] active|archived|trashed
       # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
@@ -61,6 +69,16 @@ module Basecamp
         end
       end
 
+      # Record that the current user visited a project, moving it to the front of ListRecentProjects (returns 204 No Content).
+      # @param project_id [Integer] project id ID
+      # @return [void]
+      def record_project_visit(project_id:)
+        with_operation(service: "projects", operation: "record_project_visit", is_mutation: true, project_id: project_id) do
+          http_post("/projects/#{project_id}/recent_visit.json")
+          nil
+        end
+      end
+
       # Restore a project to active status from trash as well as from the archive (returns 204 No Content).
       # @param project_id [Integer] project id ID
       # @return [void]

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

@@ -23,6 +23,25 @@ module Basecamp
         end
       end
 
+      # Put a recording's card in the spotlight area on its project or template home page.
+      # @param recording_id [Integer] recording id ID
+      # @return [Hash] response data
+      def spotlight(recording_id:)
+        with_operation(service: "recordings", operation: "spotlight", is_mutation: true, resource_id: recording_id) do
+          http_post("/recordings/#{recording_id}/spotlight.json").json
+        end
+      end
+
+      # Remove a recording from the spotlight area.
+      # @param recording_id [Integer] recording id ID
+      # @return [void]
+      def unspotlight(recording_id:)
+        with_operation(service: "recordings", operation: "unspotlight", is_mutation: true, resource_id: recording_id) do
+          http_delete("/recordings/#{recording_id}/spotlight.json")
+          nil
+        end
+      end
+
       # Unarchive a recording (restore to active status)
       # @param recording_id [Integer] recording id ID
       # @return [void]

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

@@ -7,6 +7,34 @@ module Basecamp
     # @generated from OpenAPI spec
     class TemplatesService < BaseService
 
+      # Get the account's to-do list template library
+      # @return [Hash] response data
+      def get_library()
+        with_operation(service: "templates", operation: "get_library", is_mutation: false) do
+          http_get("/template_library.json", operation: "GetTemplateLibrary").json
+        end
+      end
+
+      # Start copying a to-do list template into a project
+      # @param template_recording_id [Integer] template recording id
+      # @param destination_parent_id [Integer] destination parent id
+      # @param adding_people_confirmed [Boolean, nil] Confirm granting destination-project access to people referenced by the template.
+      # @return [Hash] response data
+      def create_library_copy(template_recording_id:, destination_parent_id:, adding_people_confirmed: nil)
+        with_operation(service: "templates", operation: "create_library_copy", is_mutation: true) do
+          http_post("/template_library/copies.json", body: compact_params(template_recording_id: template_recording_id, destination_parent_id: destination_parent_id, adding_people_confirmed: adding_people_confirmed)).json
+        end
+      end
+
+      # Get the current status of a to-do list template copy
+      # @param copy_id [Integer] copy id ID
+      # @return [Hash] response data
+      def get_library_copy(copy_id:)
+        with_operation(service: "templates", operation: "get_library_copy", is_mutation: false, resource_id: copy_id) do
+          http_get("/template_library/copies/#{copy_id}", operation: "GetTemplateLibraryCopy").json
+        end
+      end
+
       # List all templates visible to the current user
       # @param status [String, nil] active|archived|trashed
       # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.