basecamp-sdk 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ad400c464ec41bcb8b70b0428d71db268a884690740c5b9ae9791330a4244e1
-  data.tar.gz: 4937023d3d87ae38eee8eea728ed7b5007fa0413d64f0f0cfff977085eaae923
+  metadata.gz: 2d9ac0d518ad24aed0762084bbe6d5e086652d2b10cd6d7f28ba0afa839fa2cd
+  data.tar.gz: 7dbc3a032f0e0fbe6f2993db0c588d44b4a2aaebde9764004820845eac3bacc5
 SHA512:
-  metadata.gz: ffb28e6c920ea19b9cf419e240f107b478fb726bfb23f5437441b96aeeca7c9ec660cec8e3ef362bb3c5e6cc6606067e6de28c4f567d06ff2ef838f2aec45714
-  data.tar.gz: 625a648b06c1067281e0975b801e8b78f4156fb1091f3e9fa1e12de8ae6c0708f538fd6eda17410433a3779fe732fd1dfd1e87c34aed869b3d13b7381f2aa3dd
+  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-03-03T21:53:53Z",
+  "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/types.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Auto-generated from OpenAPI spec. Do not edit manually.
-# Generated: 2026-03-03T21:53:53Z
+# 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.2"
+  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.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Basecamp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-04 00:00:00.000000000 Z
+date: 2026-03-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday