basecamp-sdk 0.26.0 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fd42c71ec94ed3fca5d41b7f015309154da9cba442bd5d7e1a4daa41fcc47f7
-  data.tar.gz: 38b36b58f82eb91498ec501a1d497ea18210ad07a7f4548820350a3f69c08724
+  metadata.gz: 69a94db94f0ff533b6160519f9ed6e41089ef70639d36e7042668f8ba5c819e9
+  data.tar.gz: a19a2cf4cff6180e1671e826bc6a9e93794576c05af574c0cd0ab64296a361e7
 SHA512:
-  metadata.gz: 89dd7bc9af9f11a0365f768ffec3a6335b801f4278834dfadbbfe5963046f4da5f33bece26b8b112798896128e2def06c405d31f04b7f07b29e7432a384b9d83
-  data.tar.gz: 716839ec940b554a08f9049ec03caa88090e7965575dd29567545a38e04f8cd46176daf2de2882df079c32684f339e1b4c7ad09be523e0840854b0e0240919c3
+  metadata.gz: bec94397b02003677dd55ce96cb2786c4d0f8b502097f564086187c74ba767e6191b0104ca9d67eaece577664646a1f6828e877b9407e2f6c7613ad9c8c36c5d
+  data.tar.gz: 5523532f3233eecefc27ec7ca6c0048513f66fee6b53986be5458c120f83f75be65509de87eaeb22e84f2814356f30758d64fb1df392cc63dc5a76bb2bb7d8b5

data/README.md

@@ -349,6 +349,7 @@ The SDK provides the full account-scoped service set documented in SPEC §5. The
 | `card_steps` | Card workflow steps |
 | `subtasks` | Subtasks (checklist items) on to-dos and cards |
 | `pings` | Pings (direct and group chats) |
+| `embeds` | Embeds for rich text (create, get) |
 | `wormholes` | Card table wormholes (cross-project moves) |
 | `lineup` | Card lineup view |
 | `tools` | Project dock tools |

data/lib/basecamp/client.rb

@@ -617,6 +617,10 @@ module Basecamp
       service(:pings) { Services::PingsService.new(self) }
     end
 
+    def embeds
+      service(:embeds) { Services::EmbedsService.new(self) }
+    end
+
     # @return [Services::AccountService]
     def account
       service(:account) { Services::AccountService.new(self) }

data/lib/basecamp/generated/metadata.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-10-19T21:23:14Z",
+  "generated": "2026-10-20T15:47:49Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -1134,6 +1134,30 @@
         "natural": true
       }
     },
+    "CreateEmbed": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "GetEmbed": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "PollEvents": {
       "retry": {
         "maxAttempts": 3,

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

@@ -162,6 +162,10 @@ module Basecamp
         kwargs.compact
       end
 
+      def path_segment(value)
+        CGI.escapeURIComponent(value.to_s)
+      end
+
       # Like compact_params, but also drops empty arrays. For query filters an
       # empty array means "no filter" and must be omitted entirely: Faraday's
       # nested encoder would otherwise emit a bare `bucket_ids[]`, which Rails

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for Embeds operations
+    #
+    # @generated from OpenAPI spec
+    class EmbedsService < BaseService
+
+      # Create an embed for a URL, or return the one Basecamp already has for it.
+      # @param url [String] The URL of the content to embed.
+      # @return [Hash] response data
+      def create(url:)
+        with_operation(service: "embeds", operation: "create", is_mutation: true) do
+          http_post("/embeds.json", body: compact_params(url: url)).json(operation: "CreateEmbed")
+        end
+      end
+
+      # Get an embed by its sgid.
+      # @param sgid [String] An embed's signed global id, an opaque string.
+      # @return [Hash] response data
+      def get(sgid:)
+        with_operation(service: "embeds", operation: "get", is_mutation: false) do
+          http_get("/embeds/#{path_segment(sgid)}", operation: "GetEmbed").json(operation: "GetEmbed")
+        end
+      end
+    end
+  end
+end

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

@@ -72,7 +72,7 @@ module Basecamp
       # @return [Hash] response data
       def get_entry_occurrence(entry_id:, date:)
         with_operation(service: "schedules", operation: "get_entry_occurrence", is_mutation: false, resource_id: entry_id) do
-          http_get("/schedule_entries/#{entry_id}/occurrences/#{date}", operation: "GetScheduleEntryOccurrence").json(operation: "GetScheduleEntryOccurrence")
+          http_get("/schedule_entries/#{entry_id}/occurrences/#{path_segment(date)}", operation: "GetScheduleEntryOccurrence").json(operation: "GetScheduleEntryOccurrence")
         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-10-19T21:23:14Z
+# Generated: 2026-10-20T15:47:49Z
 
 require "json"
 require "time"
@@ -1685,6 +1685,43 @@ module Basecamp
       end
     end
 
+    # Embed
+    class Embed
+      include TypeHelpers
+      attr_accessor :sgid, :status, :url, :content, :content_type, :image_url, :type
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[sgid status url].freeze
+      end
+
+      def initialize(data = {})
+        @sgid = data["sgid"]
+        @status = data["status"]
+        @url = data["url"]
+        @content = data["content"]
+        @content_type = data["content_type"]
+        @image_url = data["image_url"]
+        @type = data["type"]
+      end
+
+      def to_h
+        {
+          "sgid" => @sgid,
+          "status" => @status,
+          "url" => @url,
+          "content" => @content,
+          "content_type" => @content_type,
+          "image_url" => @image_url,
+          "type" => @type,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
     # Event
     class Event
       include TypeHelpers

data/lib/basecamp/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Basecamp
-  VERSION = "0.26.0"
+  VERSION = "0.27.0"
   API_VERSION = "2026-10-19"
 end

data/scripts/generate-services.rb

@@ -84,6 +84,7 @@ class ServiceGenerator
     'Boosts' => 'Boosts',
     'Subtasks' => 'Subtasks',
     'Pings' => 'Pings',
+    'Embeds' => 'Embeds',
     'Untagged' => 'Miscellaneous'
   }.freeze
 
@@ -365,7 +366,7 @@ class ServiceGenerator
     clientcorrespondences clientreply clientreplies forwardreply
     forwardreplies campfireline campfirelines todolistgroup todolistgroups
     todolistorgroup uploadversions hillchart hillcharts subtask subtasks ping pings
-    wormhole wormholes
+    wormhole wormholes embed embeds
   ].freeze
 
   def initialize(openapi_path)
@@ -571,7 +572,7 @@ class ServiceGenerator
       operation_id: operation_id,
       method_name: method_name,
       http_method: http_method,
-      path: convert_path(path),
+      path: convert_path(path, path_params),
       description: description,
       path_params: path_params,
       query_params: query_params,
@@ -679,14 +680,15 @@ class ServiceGenerator
     SIMPLE_RESOURCES.include?(resource.downcase.gsub('_', ''))
   end
 
-  def convert_path(path)
+  def convert_path(path, path_params = [])
     # Remove /{accountId} prefix
     path = path.sub(%r{^/\{accountId\}}, '')
+    string_params = path_params.select { |p| p[:type] == 'String' }.map { |p| p[:name] }
     # Convert {camelCaseParam} to #{snake_case_param}
     path.gsub(/\{(\w+)\}/) do |_match|
       param = ::Regexp.last_match(1)
       snake_param = to_snake_case(param)
-      "\#{#{snake_param}}"
+      string_params.include?(param) ? "\#{path_segment(#{snake_param})}" : "\#{#{snake_param}}"
     end
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: basecamp-sdk
 version: !ruby/object:Gem::Version
-  version: 0.26.0
+  version: 0.27.0
 platform: ruby
 authors:
 - Basecamp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-20 00:00:00.000000000 Z
+date: 2026-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -202,6 +202,7 @@ files:
 - lib/basecamp/generated/services/comments_service.rb
 - lib/basecamp/generated/services/documents_service.rb
 - lib/basecamp/generated/services/drafts_service.rb
+- lib/basecamp/generated/services/embeds_service.rb
 - lib/basecamp/generated/services/event_feed_service.rb
 - lib/basecamp/generated/services/events_service.rb
 - lib/basecamp/generated/services/everything_service.rb