basecamp-sdk 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5251d36b00bfd269e7fce1bc324c2c9b491b9d0f0d30296807c0b1b724272adc
-  data.tar.gz: c590cec999d1b5c687456d8cdf1259712df2fcb26260048410ac5edd41dd772b
+  metadata.gz: 2d9ac0d518ad24aed0762084bbe6d5e086652d2b10cd6d7f28ba0afa839fa2cd
+  data.tar.gz: 7dbc3a032f0e0fbe6f2993db0c588d44b4a2aaebde9764004820845eac3bacc5
 SHA512:
-  metadata.gz: 874a76ab2b404c5ad8bada234f9002ba4e50d3ad5e574352d0f6cc53991efa656f0adb0ddd1701df52e66966ed201740b1156c9aaa7a3193422c9ab82fa877ae
-  data.tar.gz: 05570761aa1e7a59823ed614505391415f883b41fcf7ba4b4197f51ad2ad07cf7ce9d7ecd7722ecfe7e60d759fb963638f7bfe621b20406233dcf1b0a1909400
+  metadata.gz: 2914132d8a9a6a9dba9b14bd10e36fbab735ec9a564342cb9f44aed6c4c766687f4462e9264284bba46a31d3ab614ddf9fdc9350c7726e17517ba358769b6a05
+  data.tar.gz: be5c86123641a00cb716b2c1d87daaff532fe5da7c6aa30665401a9d0eefdad300895f1ce2cce937c984f1b59e046916b3b9197baf55da2c4f85ec90d1dd47c0

data/lib/basecamp/errors.rb

@@ -56,6 +56,9 @@ module Basecamp
     # @return [Integer, nil] seconds to wait before retrying (for rate limits)
     attr_reader :retry_after
 
+    # @return [String, nil] X-Request-Id from the response
+    attr_reader :request_id
+
     # @return [Exception, nil] original error that caused this error
     attr_reader :cause
 
@@ -65,14 +68,16 @@ module Basecamp
     # @param http_status [Integer, nil] HTTP status code
     # @param retryable [Boolean] whether operation can be retried
     # @param retry_after [Integer, nil] seconds to wait before retry
+    # @param request_id [String, nil] X-Request-Id from response
     # @param cause [Exception, nil] underlying cause
-    def initialize(code:, message:, hint: nil, http_status: nil, retryable: false, retry_after: nil, cause: nil)
+    def initialize(code:, message:, hint: nil, http_status: nil, retryable: false, retry_after: nil, request_id: nil, cause: nil)
       super(message)
       @code = code
       @hint = hint
       @http_status = http_status
       @retryable = retryable
       @retry_after = retry_after
+      @request_id = request_id
       @cause = cause
     end
 

data/lib/basecamp/generated/metadata.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-02-27T01:07:43Z",
+  "generated": "2026-03-09T19:39:33Z",
   "operations": {
     "CreateAttachment": {
       "retry": {
@@ -515,6 +515,33 @@
         "natural": true
       }
     },
+    "ListCampfireUploads": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
+    "CreateCampfireUpload": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 2000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "ListPingablePeople": {
       "retry": {
         "maxAttempts": 3,

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

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "uri"
+
 module Basecamp
   module Services
     # Service for Campfires operations
@@ -117,6 +119,27 @@ module Basecamp
           nil
         end
       end
+
+      # List uploaded files in a campfire
+      # @param campfire_id [Integer] campfire id ID
+      # @return [Enumerator<Hash>] paginated results
+      def list_uploads(campfire_id:)
+        wrap_paginated(service: "campfires", operation: "list_uploads", is_mutation: false, resource_id: campfire_id) do
+          paginate("/chats/#{campfire_id}/uploads.json")
+        end
+      end
+
+      # Upload a file to a campfire
+      # @param campfire_id [Integer] campfire id ID
+      # @param data [String] Binary file data to upload
+      # @param content_type [String] MIME type of the file (e.g., "application/pdf", "image/png")
+      # @param name [String] Filename for the uploaded file (e.g. "report.pdf").
+      # @return [Hash] response data
+      def create_upload(campfire_id:, data:, content_type:, name:)
+        with_operation(service: "campfires", operation: "create_upload", is_mutation: true, resource_id: campfire_id) do
+          http_post_raw("/chats/#{campfire_id}/uploads.json?name=#{URI.encode_www_form_component(name.to_s)}", body: data, content_type: content_type).json
+        end
+      end
     end
   end
 end

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

@@ -41,10 +41,11 @@ module Basecamp
       # @param title [String] title
       # @param content [String, nil] content
       # @param status [String, nil] active|drafted
+      # @param subscriptions [Array, nil] subscriptions
       # @return [Hash] response data
-      def create(vault_id:, title:, content: nil, status: nil)
+      def create(vault_id:, title:, content: nil, status: nil, subscriptions: nil)
         with_operation(service: "documents", operation: "create", is_mutation: true, resource_id: vault_id) do
-          http_post("/vaults/#{vault_id}/documents.json", body: compact_params(title: title, content: content, status: status)).json
+          http_post("/vaults/#{vault_id}/documents.json", body: compact_params(title: title, content: content, status: status, subscriptions: subscriptions)).json
         end
       end
     end

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

@@ -22,10 +22,11 @@ module Basecamp
       # @param content [String, nil] content
       # @param status [String, nil] active|drafted
       # @param category_id [Integer, nil] category id
+      # @param subscriptions [Array, nil] subscriptions
       # @return [Hash] response data
-      def create(board_id:, subject:, content: nil, status: nil, category_id: nil)
+      def create(board_id:, subject:, content: nil, status: nil, category_id: nil, subscriptions: nil)
         with_operation(service: "messages", operation: "create", is_mutation: true, resource_id: board_id) do
-          http_post("/message_boards/#{board_id}/messages.json", body: compact_params(subject: subject, content: content, status: status, category_id: category_id)).json
+          http_post("/message_boards/#{board_id}/messages.json", body: compact_params(subject: subject, content: content, status: status, category_id: category_id, subscriptions: subscriptions)).json
         end
       end
 

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

@@ -81,10 +81,11 @@ module Basecamp
       # @param participant_ids [Array, nil] participant ids
       # @param all_day [Boolean, nil] all day
       # @param notify [Boolean, nil] notify
+      # @param subscriptions [Array, nil] subscriptions
       # @return [Hash] response data
-      def create_entry(schedule_id:, summary:, starts_at:, ends_at:, description: nil, participant_ids: nil, all_day: nil, notify: nil)
+      def create_entry(schedule_id:, summary:, starts_at:, ends_at:, description: nil, participant_ids: nil, all_day: nil, notify: nil, subscriptions: nil)
         with_operation(service: "schedules", operation: "create_entry", is_mutation: true, resource_id: schedule_id) do
-          http_post("/schedules/#{schedule_id}/entries.json", body: compact_params(summary: summary, starts_at: starts_at, ends_at: ends_at, description: description, participant_ids: participant_ids, all_day: all_day, notify: notify)).json
+          http_post("/schedules/#{schedule_id}/entries.json", body: compact_params(summary: summary, starts_at: starts_at, ends_at: ends_at, description: description, participant_ids: participant_ids, all_day: all_day, notify: notify, subscriptions: subscriptions)).json
         end
       end
     end

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

@@ -50,10 +50,11 @@ module Basecamp
       # @param attachable_sgid [String] attachable sgid
       # @param description [String, nil] description
       # @param base_name [String, nil] base name
+      # @param subscriptions [Array, nil] subscriptions
       # @return [Hash] response data
-      def create(vault_id:, attachable_sgid:, description: nil, base_name: nil)
+      def create(vault_id:, attachable_sgid:, description: nil, base_name: nil, subscriptions: nil)
         with_operation(service: "uploads", operation: "create", is_mutation: true, resource_id: vault_id) do
-          http_post("/vaults/#{vault_id}/uploads.json", body: compact_params(attachable_sgid: attachable_sgid, description: description, base_name: base_name)).json
+          http_post("/vaults/#{vault_id}/uploads.json", body: compact_params(attachable_sgid: attachable_sgid, description: description, base_name: base_name, subscriptions: subscriptions)).json
         end
       end
     end

data/lib/basecamp/generated/types.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Auto-generated from OpenAPI spec. Do not edit manually.
-# Generated: 2026-02-27T01:07:43Z
+# Generated: 2026-03-09T19:39:33Z
 
 require "json"
 require "time"
@@ -136,7 +136,7 @@ module Basecamp
     # Campfire
     class Campfire
       include TypeHelpers
-      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :status, :title, :type, :updated_at, :url, :visible_to_clients, :bookmark_url, :lines_url, :position, :subscription_url, :topic
+      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :status, :title, :type, :updated_at, :url, :visible_to_clients, :bookmark_url, :files_url, :lines_url, :position, :subscription_url, :topic
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -157,6 +157,7 @@ module Basecamp
         @url = data["url"]
         @visible_to_clients = parse_boolean(data["visible_to_clients"])
         @bookmark_url = data["bookmark_url"]
+        @files_url = data["files_url"]
         @lines_url = data["lines_url"]
         @position = parse_integer(data["position"])
         @subscription_url = data["subscription_url"]
@@ -178,6 +179,7 @@ module Basecamp
           "url" => @url,
           "visible_to_clients" => @visible_to_clients,
           "bookmark_url" => @bookmark_url,
+          "files_url" => @files_url,
           "lines_url" => @lines_url,
           "position" => @position,
           "subscription_url" => @subscription_url,
@@ -193,17 +195,16 @@ module Basecamp
     # CampfireLine
     class CampfireLine
       include TypeHelpers
-      attr_accessor :app_url, :bucket, :content, :created_at, :creator, :id, :inherits_status, :parent, :status, :title, :type, :updated_at, :url, :visible_to_clients, :bookmark_url, :boosts_count, :boosts_url
+      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :parent, :status, :title, :type, :updated_at, :url, :visible_to_clients, :attachments, :bookmark_url, :boosts_count, :boosts_url, :content
 
       # @return [Array<Symbol>]
       def self.required_fields
-        %i[app_url bucket content created_at creator id inherits_status parent status title type updated_at url visible_to_clients].freeze
+        %i[app_url bucket created_at creator id inherits_status parent status title type updated_at url visible_to_clients].freeze
       end
 
       def initialize(data = {})
         @app_url = data["app_url"]
         @bucket = parse_type(data["bucket"], "TodoBucket")
-        @content = data["content"]
         @created_at = parse_datetime(data["created_at"])
         @creator = parse_type(data["creator"], "Person")
         @id = parse_integer(data["id"])
@@ -215,16 +216,17 @@ module Basecamp
         @updated_at = parse_datetime(data["updated_at"])
         @url = data["url"]
         @visible_to_clients = parse_boolean(data["visible_to_clients"])
+        @attachments = parse_array(data["attachments"], "CampfireLineAttachment")
         @bookmark_url = data["bookmark_url"]
         @boosts_count = parse_integer(data["boosts_count"])
         @boosts_url = data["boosts_url"]
+        @content = data["content"]
       end
 
       def to_h
         {
           "app_url" => @app_url,
           "bucket" => @bucket,
-          "content" => @content,
           "created_at" => @created_at,
           "creator" => @creator,
           "id" => @id,
@@ -236,9 +238,41 @@ module Basecamp
           "updated_at" => @updated_at,
           "url" => @url,
           "visible_to_clients" => @visible_to_clients,
+          "attachments" => @attachments,
           "bookmark_url" => @bookmark_url,
           "boosts_count" => @boosts_count,
           "boosts_url" => @boosts_url,
+          "content" => @content,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
+    # CampfireLineAttachment
+    class CampfireLineAttachment
+      include TypeHelpers
+      attr_accessor :byte_size, :content_type, :download_url, :filename, :title, :url
+
+      def initialize(data = {})
+        @byte_size = parse_integer(data["byte_size"])
+        @content_type = data["content_type"]
+        @download_url = data["download_url"]
+        @filename = data["filename"]
+        @title = data["title"]
+        @url = data["url"]
+      end
+
+      def to_h
+        {
+          "byte_size" => @byte_size,
+          "content_type" => @content_type,
+          "download_url" => @download_url,
+          "filename" => @filename,
+          "title" => @title,
+          "url" => @url,
         }.compact
       end
 

data/lib/basecamp/http.rb

@@ -244,7 +244,7 @@ module Basecamp
           status: response.status,
           headers: response.headers
         )
-      rescue Faraday::ClientError => e
+      rescue Faraday::ServerError, Faraday::ClientError => e
         duration = Process.clock_gettime(Process::CLOCK_MONOTONIC) - start_time
         error = handle_error(e)
         result = RequestResult.new(
@@ -299,7 +299,7 @@ module Basecamp
           status: response.status,
           headers: response.headers
         )
-      rescue Faraday::ClientError => e
+      rescue Faraday::ServerError, Faraday::ClientError => e
         duration = Process.clock_gettime(Process::CLOCK_MONOTONIC) - start_time
         error = handle_error(e)
         result = RequestResult.new(
@@ -325,12 +325,12 @@ module Basecamp
       headers = error.response&.dig(:headers) || {}
 
       retry_after = parse_retry_after(headers["Retry-After"] || headers["retry-after"])
+      request_id = headers["X-Request-Id"] || headers["x-request-id"]
 
-      case status
+      err = case status
       when 401
         # Try token refresh; flag for caller to retry
         @token_refreshed = @token_provider&.refreshable? && @token_provider.refresh
-
         Basecamp::AuthError.new("Authentication failed")
       when 403
         Basecamp::ForbiddenError.new("Access denied")
@@ -342,13 +342,16 @@ module Basecamp
         message = Security.truncate(Basecamp.parse_error_message(body) || "Validation failed")
         Basecamp::ValidationError.new(message, http_status: status)
       when 500
-        Basecamp::APIError.new("Server error (500)", http_status: 500)
+        Basecamp::APIError.new("Server error (500)", http_status: 500, retryable: true)
       when 502, 503, 504
         Basecamp::APIError.new("Gateway error (#{status})", http_status: status, retryable: true)
       else
         message = Security.truncate(Basecamp.parse_error_message(body) || "Request failed (HTTP #{status})")
         Basecamp::APIError.from_status(status || 0, message)
       end
+
+      err.instance_variable_set(:@request_id, request_id) if request_id
+      err
     end
 
     def build_url(path)

data/lib/basecamp/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Basecamp
-  VERSION = "0.2.1"
+  VERSION = "0.2.3"
   API_VERSION = "2026-01-26"
 end

data/scripts/generate-services.rb

@@ -45,6 +45,7 @@ class ServiceGenerator
         GetCampfire ListCampfires
         ListChatbots CreateChatbot GetChatbot UpdateChatbot DeleteChatbot
         ListCampfireLines CreateCampfireLine GetCampfireLine DeleteCampfireLine
+        ListCampfireUploads CreateCampfireUpload
       ]
     },
     'Card Tables' => {
@@ -188,6 +189,8 @@ class ServiceGenerator
     'CreateCampfireLine' => 'create_line',
     'GetCampfireLine' => 'get_line',
     'DeleteCampfireLine' => 'delete_line',
+    'ListCampfireUploads' => 'list_uploads',
+    'CreateCampfireUpload' => 'create_upload',
     # Forwards - use specific names to avoid conflicts between forwards, replies, and inbox
     'GetForward' => 'get',
     'ListForwards' => 'list',

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: basecamp-sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.3
 platform: ruby
 authors:
 - Basecamp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-28 00:00:00.000000000 Z
+date: 2026-03-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday