basecamp-sdk 0.10.0 → 0.12.0

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-07-28T21:34:14Z
+# Generated: 2026-07-31T15:59:31Z
 
 require "json"
 require "time"
@@ -255,6 +255,62 @@ module Basecamp
       end
     end
 
+    # Bookmark
+    class Bookmark
+      include TypeHelpers
+      attr_accessor :created_at, :id, :recording, :updated_at
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[created_at id recording updated_at].freeze
+      end
+
+      def initialize(data = {})
+        @created_at = parse_datetime(data["created_at"])
+        @id = parse_integer(data["id"])
+        @recording = parse_type(data["recording"], "Recording")
+        @updated_at = parse_datetime(data["updated_at"])
+      end
+
+      def to_h
+        {
+          "created_at" => @created_at,
+          "id" => @id,
+          "recording" => @recording,
+          "updated_at" => @updated_at,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
+    # BookmarkStatus
+    class BookmarkStatus
+      include TypeHelpers
+      attr_accessor :bookmarked
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[bookmarked].freeze
+      end
+
+      def initialize(data = {})
+        @bookmarked = parse_boolean(data["bookmarked"])
+      end
+
+      def to_h
+        {
+          "bookmarked" => @bookmarked,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
     # Boost
     class Boost
       include TypeHelpers
@@ -342,6 +398,72 @@ module Basecamp
       end
     end
 
+    # Calendar
+    class Calendar
+      include TypeHelpers
+      attr_accessor :app_url, :color, :created_at, :id, :name, :schedule_url, :type, :updated_at, :url
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[app_url color created_at id name schedule_url type updated_at url].freeze
+      end
+
+      def initialize(data = {})
+        @app_url = data["app_url"]
+        @color = data["color"]
+        @created_at = parse_datetime(data["created_at"])
+        @id = parse_integer(data["id"])
+        @name = data["name"]
+        @schedule_url = data["schedule_url"]
+        @type = data["type"]
+        @updated_at = parse_datetime(data["updated_at"])
+        @url = data["url"]
+      end
+
+      def to_h
+        {
+          "app_url" => @app_url,
+          "color" => @color,
+          "created_at" => @created_at,
+          "id" => @id,
+          "name" => @name,
+          "schedule_url" => @schedule_url,
+          "type" => @type,
+          "updated_at" => @updated_at,
+          "url" => @url,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
+    # CalendarAttributes
+    class CalendarAttributes
+      include TypeHelpers
+      attr_accessor :color
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[color].freeze
+      end
+
+      def initialize(data = {})
+        @color = data["color"]
+      end
+
+      def to_h
+        {
+          "color" => @color,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
     # Campfire
     class Campfire
       include TypeHelpers
@@ -1351,6 +1473,107 @@ module Basecamp
       end
     end
 
+    # Draft
+    class Draft
+      include TypeHelpers
+      attr_accessor :app_url, :bucket, :created_at, :excerpt, :id, :parent, :scheduled_posting_at, :title, :type, :updated_at
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[app_url bucket created_at excerpt id parent scheduled_posting_at title type updated_at].freeze
+      end
+
+      def initialize(data = {})
+        @app_url = data["app_url"]
+        @bucket = parse_type(data["bucket"], "DraftBucket")
+        @created_at = parse_datetime(data["created_at"])
+        @excerpt = data["excerpt"]
+        @id = parse_integer(data["id"])
+        @parent = data["parent"]
+        @scheduled_posting_at = data["scheduled_posting_at"]
+        @title = data["title"]
+        @type = data["type"]
+        @updated_at = parse_datetime(data["updated_at"])
+      end
+
+      def to_h
+        {
+          "app_url" => @app_url,
+          "bucket" => @bucket,
+          "created_at" => @created_at,
+          "excerpt" => @excerpt,
+          "id" => @id,
+          "parent" => @parent,
+          "scheduled_posting_at" => @scheduled_posting_at,
+          "title" => @title,
+          "type" => @type,
+          "updated_at" => @updated_at,
+        }.reject { |k, v| v.nil? && !["scheduled_posting_at"].include?(k) }
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
+    # DraftBucket
+    class DraftBucket
+      include TypeHelpers
+      attr_accessor :app_url, :id, :name
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[app_url id name].freeze
+      end
+
+      def initialize(data = {})
+        @app_url = data["app_url"]
+        @id = parse_integer(data["id"])
+        @name = data["name"]
+      end
+
+      def to_h
+        {
+          "app_url" => @app_url,
+          "id" => @id,
+          "name" => @name,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
+    # DraftParent
+    class DraftParent
+      include TypeHelpers
+      attr_accessor :app_url, :id, :title
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[app_url id title].freeze
+      end
+
+      def initialize(data = {})
+        @app_url = data["app_url"]
+        @id = parse_integer(data["id"])
+        @title = data["title"]
+      end
+
+      def to_h
+        {
+          "app_url" => @app_url,
+          "id" => @id,
+          "title" => @title,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
     # Event
     class Event
       include TypeHelpers
@@ -1414,39 +1637,6 @@ module Basecamp
       end
     end
 
-    # EverythingBoost
-    class EverythingBoost
-      include TypeHelpers
-      attr_accessor :booster, :content, :created_at, :id, :recording
-
-      # @return [Array<Symbol>]
-      def self.required_fields
-        %i[booster content created_at id recording].freeze
-      end
-
-      def initialize(data = {})
-        @booster = parse_type(data["booster"], "Person")
-        @content = data["content"]
-        @created_at = parse_datetime(data["created_at"])
-        @id = parse_integer(data["id"])
-        @recording = parse_type(data["recording"], "Recording")
-      end
-
-      def to_h
-        {
-          "booster" => @booster,
-          "content" => @content,
-          "created_at" => @created_at,
-          "id" => @id,
-          "recording" => @recording,
-        }.compact
-      end
-
-      def to_json(*args)
-        to_h.to_json(*args)
-      end
-    end
-
     # EverythingFile
     class EverythingFile
       include TypeHelpers
@@ -1529,6 +1719,31 @@ module Basecamp
       end
     end
 
+    # FieldKeyedErrors
+    class FieldKeyedErrors
+      include TypeHelpers
+      attr_accessor :errors
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[errors].freeze
+      end
+
+      def initialize(data = {})
+        @errors = parse_type(data["errors"], "FieldErrorMap")
+      end
+
+      def to_h
+        {
+          "errors" => @errors,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
     # Forward
     class Forward
       include TypeHelpers
@@ -2312,6 +2527,70 @@ module Basecamp
       end
     end
 
+    # MyNote
+    class MyNote
+      include TypeHelpers
+      attr_accessor :app_url, :content, :content_attachments, :created_at, :id, :type, :updated_at, :url
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[app_url content content_attachments created_at id type updated_at url].freeze
+      end
+
+      def initialize(data = {})
+        @app_url = data["app_url"]
+        @content = data["content"]
+        @content_attachments = parse_array(data["content_attachments"], "RichTextAttachment")
+        @created_at = data["created_at"]
+        @id = data["id"]
+        @type = data["type"]
+        @updated_at = data["updated_at"]
+        @url = data["url"]
+      end
+
+      def to_h
+        {
+          "app_url" => @app_url,
+          "content" => @content,
+          "content_attachments" => @content_attachments,
+          "created_at" => @created_at,
+          "id" => @id,
+          "type" => @type,
+          "updated_at" => @updated_at,
+          "url" => @url,
+        }.reject { |k, v| v.nil? && !["created_at", "id", "updated_at"].include?(k) }
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
+    # MyNoteAttributes
+    class MyNoteAttributes
+      include TypeHelpers
+      attr_accessor :content
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[content].freeze
+      end
+
+      def initialize(data = {})
+        @content = data["content"]
+      end
+
+      def to_h
+        {
+          "content" => @content,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
     # Notification
     class Notification
       include TypeHelpers

data/lib/basecamp/http.rb

@@ -55,9 +55,12 @@ module Basecamp
     # Performs a GET request.
     # @param path [String] URL path
     # @param params [Hash] query parameters
+    # @param operation [String, nil] canonical operation ID; when given, the
+    #   operation's declared retry block governs attempts (max as a ceiling on
+    #   the configured cap) and retryable statuses (the declared retryOn set)
     # @return [Response]
-    def get(path, params: {})
-      request(:get, path, params: params)
+    def get(path, params: {}, operation: nil)
+      request(:get, path, params: params, operation: operation)
     end
 
     # Performs a GET request to an absolute URL.
@@ -171,8 +174,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: {}, &block)
-      return to_enum(:paginate, path, params: params) unless block
+    def paginate(path, params: {}, operation: nil, &block)
+      return to_enum(:paginate, path, params: params, operation: operation) unless block
 
       base_url = build_url(path)
       url = base_url
@@ -183,7 +186,7 @@ module Basecamp
         break if page > @config.max_pages
 
         @hooks.on_paginate(url, page)
-        response = get(url, params: page == 1 ? params : {})
+        response = get(url, params: page == 1 ? params : {}, operation: operation)
 
         Security.check_body_size!(response.body, Security::MAX_RESPONSE_BODY_BYTES)
 
@@ -217,8 +220,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: {}, &block)
-      return to_enum(:paginate_key, path, key: key, params: params) unless block
+    def paginate_key(path, key:, params: {}, operation: nil, &block)
+      return to_enum(:paginate_key, path, key: key, params: params, operation: operation) unless block
 
       base_url = build_url(path)
       url = base_url
@@ -229,7 +232,7 @@ module Basecamp
         break if page > @config.max_pages
 
         @hooks.on_paginate(url, page)
-        response = get(url, params: page == 1 ? params : {})
+        response = get(url, params: page == 1 ? params : {}, operation: operation)
 
         Security.check_body_size!(response.body, Security::MAX_RESPONSE_BODY_BYTES)
 
@@ -266,11 +269,11 @@ 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: {})
+    def paginate_wrapped(path, key:, params: {}, operation: nil)
       base_url = build_url(path)
 
       @hooks.on_paginate(base_url, 1)
-      first_response = get(base_url, params: params)
+      first_response = get(base_url, params: params, operation: operation)
       Security.check_body_size!(first_response.body, Security::MAX_RESPONSE_BODY_BYTES)
 
       begin
@@ -304,7 +307,7 @@ module Basecamp
           end
 
           @hooks.on_paginate(next_url, page)
-          response = get(next_url)
+          response = get(next_url, operation: operation)
           Security.check_body_size!(response.body, Security::MAX_RESPONSE_BODY_BYTES)
 
           begin
@@ -340,34 +343,37 @@ module Basecamp
       end
     end
 
-    def request(method, path, params: {}, body: nil, allow_cross_origin: false)
+    def request(method, path, params: {}, body: nil, allow_cross_origin: false, operation: nil)
       url = build_url(path, allow_cross_origin: allow_cross_origin)
 
       # Mutations don't retry on 429/5xx to avoid duplicating data
       if method == :get
-        request_with_retry(method, url, params: params, allow_cross_origin: allow_cross_origin)
+        request_with_retry(method, url, params: params, allow_cross_origin: allow_cross_origin, operation: operation)
       else
         single_request(method, url, params: params, body: body, attempt: 1, allow_cross_origin: allow_cross_origin)
       end
     end
 
-    def request_with_retry(method, url, params: {}, allow_cross_origin: false)
+    def request_with_retry(method, url, params: {}, allow_cross_origin: false, operation: nil)
+      op_retry = operation && Http.operation_retry(operation)
+      caller_cap = [ @config.max_retries, 1 ].max
+      max_attempts = op_retry ? [ caller_cap, op_retry.fetch("maxAttempts") ].min : @config.max_retries
       attempt = 0
       last_error = nil
 
       loop do
         attempt += 1
-        break if attempt > @config.max_retries
+        break if attempt > max_attempts
 
         begin
           return single_request(method, url, params: params, body: nil, attempt: attempt, allow_cross_origin: allow_cross_origin)
         rescue Basecamp::RateLimitError, Basecamp::NetworkError, Basecamp::ApiError => e
-          raise e unless e.retryable?
+          raise e unless retry_eligible?(e, op_retry)
 
           last_error = e
 
           # Don't sleep if this was the last attempt
-          break if attempt >= @config.max_retries
+          break if attempt >= max_attempts
 
           delay = calculate_delay(attempt, e.retry_after)
 
@@ -377,8 +383,30 @@ module Basecamp
         end
       end
 
-      noun = @config.max_retries == 1 ? "attempt" : "attempts"
-      raise last_error || Basecamp::ApiError.new("Request failed after #{@config.max_retries} #{noun}")
+      noun = max_attempts == 1 ? "attempt" : "attempts"
+      raise last_error || Basecamp::ApiError.new("Request failed after #{max_attempts} #{noun}")
+    end
+
+    # For a governed request (operation given), a status-bearing error retries
+    # exactly when the operation's declared retryOn set says so — the error
+    # taxonomy's retryable flag neither widens the set (500 is retryable in
+    # errors.rb but not declared) nor vetoes it. Status-less errors (network
+    # failures) and all ungoverned traffic keep the taxonomy's judgment.
+    def retry_eligible?(error, op_retry)
+      if op_retry && error.http_status
+        op_retry.fetch("retryOn").include?(error.http_status)
+      else
+        error.retryable?
+      end
+    end
+
+    # Memoized per-operation retry metadata, keyed by canonical operation ID.
+    # Benign-race memoization: concurrent first loads compute identical values.
+    def self.operation_retry(operation)
+      @operation_metadata ||= JSON.parse(
+        File.read(File.join(__dir__, "generated", "metadata.json"))
+      ).fetch("operations").freeze
+      @operation_metadata.dig(operation, "retry")
     end
 
     def single_request(method, url, params:, body:, attempt:, retry_count: 0, allow_cross_origin: false)

data/lib/basecamp/oauth/device_authorization.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Oauth
+    # RFC 8628 device authorization response (the device/user code pair the user
+    # approves out of band).
+    #
+    # @attr device_code [String] The device verification code polled at the token
+    #   endpoint.
+    # @attr user_code [String] The code the user enters at the verification URI.
+    # @attr verification_uri [String] Where the user goes to approve the request.
+    # @attr verification_uri_complete [String, nil] The verification URI with the
+    #   user code pre-filled (optional; absent when the server omits it).
+    # @attr expires_in [Integer] Lifetime of the device/user codes in seconds.
+    # @attr interval [Integer] Minimum seconds to wait between token polls
+    #   (defaults to 5 when the server omits it).
+    DeviceAuthorization = Data.define(
+      :device_code,
+      :user_code,
+      :verification_uri,
+      :verification_uri_complete,
+      :expires_in,
+      :interval
+    ) do
+      def initialize(
+        device_code:,
+        user_code:,
+        verification_uri:,
+        expires_in:,
+        interval:,
+        verification_uri_complete: nil
+      )
+        super
+      end
+    end
+  end
+end