basecamp-sdk 0.8.0 → 0.9.0

data/lib/basecamp/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Basecamp
-  VERSION = "0.8.0"
-  API_VERSION = "2026-07-22"
+  VERSION = "0.9.0"
+  API_VERSION = "2026-07-24"
 end

data/scripts/generate-services.rb

@@ -60,7 +60,8 @@ class ServiceGenerator
       'CardSteps' => %w[
         GetCardStep CreateCardStep UpdateCardStep SetCardStepCompletion
         RepositionCardStep
-      ]
+      ],
+      'Wormholes' => %w[CreateWormhole UpdateWormhole DeleteWormhole]
     },
     'Files' => {
       'Attachments' => %w[CreateAttachment],
@@ -116,7 +117,7 @@ class ServiceGenerator
     },
     'Todos' => {
       'Todos' => %w[ListTodos CreateTodo GetTodo ReplaceTodo CompleteTodo UncompleteTodo TrashTodo],
-      'Todolists' => %w[GetTodolistOrGroup UpdateTodolistOrGroup ListTodolists CreateTodolist],
+      'Todolists' => %w[GetTodolistOrGroup UpdateTodolistOrGroup ListTodolists CreateTodolist RepositionTodolist],
       'Todosets' => %w[GetTodoset],
       'HillCharts' => %w[GetHillChart UpdateHillChartSettings],
       'TodolistGroups' => %w[ListTodolistGroups CreateTodolistGroup RepositionTodolistGroup]
@@ -302,6 +303,7 @@ class ServiceGenerator
     clientcorrespondences clientreply clientreplies forwardreply
     forwardreplies campfireline campfirelines todolistgroup todolistgroups
     todolistorgroup uploadversions hillchart hillcharts
+    wormhole wormholes
   ].freeze
 
   def initialize(openapi_path)
@@ -396,7 +398,12 @@ class ServiceGenerator
                    .select { |p| p['in'] == 'query' }
                    .map do |p|
       {
-        name: p['name'],
+        # Strip a trailing `[]` from bracketed array wire names (e.g.
+        # `bucket_ids[]`): the kwarg and the params-hash key are both clean
+        # `bucket_ids`, and Faraday's NestedParamsEncoder re-adds the `[]` when
+        # serializing the array value (a raw `bucket_ids[]` key would double to
+        # `bucket_ids[][]=`).
+        name: p['name'].sub(/\[\]\z/, ''),
         type: schema_to_ruby_type(p['schema']),
         required: p['required'] || false,
         description: p['description']
@@ -533,7 +540,13 @@ class ServiceGenerator
   def schema_to_ruby_type(schema)
     return 'Object' unless schema
 
-    case schema['type']
+    # Object-valued members (e.g. a `project`/`gauge`/`schedule` envelope) are passed
+    # as a Hash. Resolve $refs and treat only object-typed schemas as Hash; a string
+    # ref such as FirstWeekDay must stay String.
+    resolved = schema['$ref'] ? resolve_schema_ref(schema) : schema
+    return 'Hash' if resolved && resolved['type'] == 'object'
+
+    case resolved&.fetch('type', nil)
     when 'integer' then 'Integer'
     when 'boolean' then 'Boolean'
     when 'array' then 'Array'
@@ -691,10 +704,11 @@ class ServiceGenerator
     kwargs << "operation: \"#{op[:method_name]}\""
     kwargs << "is_mutation: #{op[:is_mutation]}"
 
-    project_param = op[:path_params].find { |p| p[:name] == 'projectId' }
-    resource_param = op[:path_params].reject { |p| p[:name] == 'projectId' }.last
+    project_param = op[:path_params].find { |p| %w[projectId bucketId].include?(p[:name]) }
+    resource_param = op[:path_params].reject { |p| %w[projectId bucketId].include?(p[:name]) }
+      .select { |p| p[:name].end_with?("Id") || p[:name] == "id" }.last
 
-    kwargs << "project_id: project_id" if project_param
+    kwargs << "project_id: #{to_snake_case(project_param[:name])}" if project_param
     kwargs << "resource_id: #{to_snake_case(resource_param[:name])}" if resource_param
 
     kwargs.join(', ')
@@ -788,7 +802,7 @@ class ServiceGenerator
     # Build params hash for query params
     if op[:query_params].any?
       param_names = op[:query_params].map { |q| "#{to_snake_case(q[:name])}: #{to_snake_case(q[:name])}" }
-      lines << "        params = compact_params(#{param_names.join(', ')})"
+      lines << "        params = compact_query_params(#{param_names.join(', ')})"
       lines << "        paginate(#{path_expr}, params: params)"
     else
       lines << "        paginate(#{path_expr})"
@@ -802,7 +816,7 @@ class ServiceGenerator
 
     if op[:query_params].any?
       param_names = op[:query_params].map { |q| "#{to_snake_case(q[:name])}: #{to_snake_case(q[:name])}" }
-      lines << "        params = compact_params(#{param_names.join(', ')})"
+      lines << "        params = compact_query_params(#{param_names.join(', ')})"
       lines << "        paginate_wrapped(#{path_expr}, key: \"#{pagination_key}\", params: params)"
     else
       lines << "        paginate_wrapped(#{path_expr}, key: \"#{pagination_key}\")"
@@ -834,7 +848,7 @@ class ServiceGenerator
       lines << "        http_#{http_method}(#{path_expr}, body: #{body_expr}).json"
     elsif op[:query_params].any?
       param_names = op[:query_params].map { |q| "#{to_snake_case(q[:name])}: #{to_snake_case(q[:name])}" }
-      lines << "        http_#{http_method}(#{path_expr}, params: compact_params(#{param_names.join(', ')})).json"
+      lines << "        http_#{http_method}(#{path_expr}, params: compact_query_params(#{param_names.join(', ')})).json"
     else
       lines << "        http_#{http_method}(#{path_expr}).json"
     end

data/scripts/generate-types.rb

@@ -124,6 +124,12 @@ if __FILE__ == $PROGRAM_NAME
 
     puts ''
     puts "    # #{name}"
+    # Documentation-only deprecation (see #406): YARD marks a whole class/method,
+    # not individual params, so a class-level @deprecated tag documents a wholly
+    # deprecated type.
+    if schema['deprecated']
+      puts "    # @deprecated #{schema['x-deprecated-reason'] || 'deprecated'}"
+    end
     puts "    class #{name}"
     puts '      include TypeHelpers'
 
@@ -131,6 +137,19 @@ if __FILE__ == $PROGRAM_NAME
     # Add system_label for schemas with flexible integer fields
     has_flexible = ordered_props.any? { |k| properties[k]['x-go-type']&.include?('FlexibleInt64') }
     attr_names << 'system_label' if has_flexible
+
+    # Per-attribute deprecation. The accessors are declared in one grouped
+    # attr_accessor, so a bare comment would wrongly document every attribute;
+    # a YARD @!attribute directive scopes the @deprecated tag to just this one.
+    ordered_props.each do |k|
+      ps = properties[k]
+      next unless ps['deprecated']
+
+      ruby_name = k.gsub(/([A-Z])/, '_\1').downcase.gsub(/^_/, '')
+      puts "      # @!attribute [rw] #{ruby_name}"
+      puts "      #   @deprecated #{ps['x-deprecated-reason'] || 'deprecated'}"
+    end
+
     puts "      attr_accessor #{attr_names.map { |n| ":#{n}" }.join(", ")}"
 
     unless required_props.empty?
@@ -182,7 +201,20 @@ if __FILE__ == $PROGRAM_NAME
       attr_name = prop_name.gsub(/([A-Z])/, '_\1').downcase.gsub(/^_/, '')
       puts "          \"#{prop_name}\" => @#{attr_name},"
     end
-    puts '        }.compact'
+    # A required-and-nullable field (OpenAPI 3.1 `type: [..., "null"]`) carries an
+    # explicit null that must survive to_h; plain .compact would drop it. Keep
+    # nil for exactly those keys — required-but-non-nullable fields still get
+    # dropped when nil, like any other nil. Everything else keeps .compact.
+    required_nullable = required_fields.select do |k|
+      t = properties[k] && properties[k]['type']
+      t.is_a?(Array) && t.include?('null')
+    end
+    if required_nullable.any?
+      keep_list = required_nullable.map { |k| "\"#{k}\"" }.join(', ')
+      puts "        }.reject { |k, v| v.nil? && ![#{keep_list}].include?(k) }"
+    else
+      puts '        }.compact'
+    end
     puts '      end'
     puts ''
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: basecamp-sdk
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Basecamp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-22 00:00:00.000000000 Z
+date: 2026-07-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -223,6 +223,7 @@ files:
 - lib/basecamp/generated/services/uploads_service.rb
 - lib/basecamp/generated/services/vaults_service.rb
 - lib/basecamp/generated/services/webhooks_service.rb
+- lib/basecamp/generated/services/wormholes_service.rb
 - lib/basecamp/generated/types.rb
 - lib/basecamp/hooks.rb
 - lib/basecamp/http.rb