basecamp-sdk 0.12.0 → 0.14.0

data/lib/basecamp/generated/metadata.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-07-31T15:59:31Z",
+  "generated": "2026-08-07T11:12:00Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -239,6 +239,131 @@
         "natural": true
       }
     },
+    "ListChatbots": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
+    "CreateChatbot": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "GetChatbot": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "UpdateChatbot": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "DeleteChatbot": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "ListClientApprovals": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
+    "ListClientCorrespondences": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
+    "ListClientReplies": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
+    "GetClientReply": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "CreateTool": {
       "retry": {
         "maxAttempts": 2,
@@ -261,6 +386,28 @@
         ]
       }
     },
+    "CreateCloudFile": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "CreateGoogleDocument": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "ListWebhooks": {
       "retry": {
         "maxAttempts": 3,
@@ -641,72 +788,6 @@
         ]
       }
     },
-    "ListChatbots": {
-      "retry": {
-        "maxAttempts": 3,
-        "baseDelayMs": 1000,
-        "backoff": "exponential",
-        "retryOn": [
-          429,
-          503
-        ]
-      },
-      "pagination": {
-        "style": "link",
-        "totalCountHeader": "X-Total-Count",
-        "maxPageSize": 50
-      }
-    },
-    "CreateChatbot": {
-      "retry": {
-        "maxAttempts": 2,
-        "baseDelayMs": 1000,
-        "backoff": "exponential",
-        "retryOn": [
-          429,
-          503
-        ]
-      }
-    },
-    "GetChatbot": {
-      "retry": {
-        "maxAttempts": 3,
-        "baseDelayMs": 1000,
-        "backoff": "exponential",
-        "retryOn": [
-          429,
-          503
-        ]
-      }
-    },
-    "UpdateChatbot": {
-      "retry": {
-        "maxAttempts": 3,
-        "baseDelayMs": 1000,
-        "backoff": "exponential",
-        "retryOn": [
-          429,
-          503
-        ]
-      },
-      "idempotent": {
-        "natural": true
-      }
-    },
-    "DeleteChatbot": {
-      "retry": {
-        "maxAttempts": 3,
-        "baseDelayMs": 1000,
-        "backoff": "exponential",
-        "retryOn": [
-          429,
-          503
-        ]
-      },
-      "idempotent": {
-        "natural": true
-      }
-    },
     "ListCampfireLines": {
       "retry": {
         "maxAttempts": 3,
@@ -832,22 +913,6 @@
         "maxPageSize": 50
       }
     },
-    "ListClientApprovals": {
-      "retry": {
-        "maxAttempts": 3,
-        "baseDelayMs": 1000,
-        "backoff": "exponential",
-        "retryOn": [
-          429,
-          503
-        ]
-      },
-      "pagination": {
-        "style": "link",
-        "totalCountHeader": "X-Total-Count",
-        "maxPageSize": 50
-      }
-    },
     "GetClientApproval": {
       "retry": {
         "maxAttempts": 3,
@@ -859,22 +924,6 @@
         ]
       }
     },
-    "ListClientCorrespondences": {
-      "retry": {
-        "maxAttempts": 3,
-        "baseDelayMs": 1000,
-        "backoff": "exponential",
-        "retryOn": [
-          429,
-          503
-        ]
-      },
-      "pagination": {
-        "style": "link",
-        "totalCountHeader": "X-Total-Count",
-        "maxPageSize": 50
-      }
-    },
     "GetClientCorrespondence": {
       "retry": {
         "maxAttempts": 3,
@@ -886,7 +935,7 @@
         ]
       }
     },
-    "ListClientReplies": {
+    "GetCloudFile": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -895,14 +944,9 @@
           429,
           503
         ]
-      },
-      "pagination": {
-        "style": "link",
-        "totalCountHeader": "X-Total-Count",
-        "maxPageSize": 50
       }
     },
-    "GetClientReply": {
+    "UpdateCloudFile": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -911,6 +955,9 @@
           429,
           503
         ]
+      },
+      "idempotent": {
+        "natural": true
       }
     },
     "GetEverythingComments": {
@@ -1004,7 +1051,7 @@
         ]
       }
     },
-    "UpdateDocument": {
+    "ReplaceDocument": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -1089,7 +1136,7 @@
         "natural": true
       }
     },
-    "GetForward": {
+    "GetGoogleDocument": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -1100,7 +1147,7 @@
         ]
       }
     },
-    "ListForwardReplies": {
+    "UpdateGoogleDocument": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -1110,21 +1157,35 @@
           503
         ]
       },
-      "pagination": {
-        "style": "link",
-        "totalCountHeader": "X-Total-Count",
-        "maxPageSize": 50
+      "idempotent": {
+        "natural": true
       }
     },
-    "CreateForwardReply": {
+    "GetForward": {
       "retry": {
-        "maxAttempts": 2,
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "ListForwardReplies": {
+      "retry": {
+        "maxAttempts": 3,
         "baseDelayMs": 1000,
         "backoff": "exponential",
         "retryOn": [
           429,
           503
         ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
       }
     },
     "GetForwardReply": {
@@ -1745,6 +1806,34 @@
         "natural": true
       }
     },
+    "UnarchiveProject": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "ArchiveProject": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "GetProjectTimeline": {
       "retry": {
         "maxAttempts": 3,
@@ -1989,17 +2078,6 @@
         "natural": true
       }
     },
-    "GetRecording": {
-      "retry": {
-        "maxAttempts": 3,
-        "baseDelayMs": 1000,
-        "backoff": "exponential",
-        "retryOn": [
-          429,
-          503
-        ]
-      }
-    },
     "GetBookmark": {
       "retry": {
         "maxAttempts": 3,
@@ -2425,7 +2503,7 @@
         ]
       }
     },
-    "UpdateScheduleEntry": {
+    "ReplaceScheduleEntry": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -2529,6 +2607,67 @@
         ]
       }
     },
+    "ListFolders": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "CreateFolder": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "GetFolder": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "UpdateFolder": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "DeleteFolder": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "ListTemplates": {
       "retry": {
         "maxAttempts": 3,
@@ -2642,6 +2781,20 @@
         "natural": true
       }
     },
+    "DestroyTimesheetEntry": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "RepositionTodolistGroup": {
       "retry": {
         "maxAttempts": 3,
@@ -2835,20 +2988,6 @@
         "natural": true
       }
     },
-    "TrashTodo": {
-      "retry": {
-        "maxAttempts": 3,
-        "baseDelayMs": 1000,
-        "backoff": "exponential",
-        "retryOn": [
-          429,
-          503
-        ]
-      },
-      "idempotent": {
-        "natural": true
-      }
-    },
     "CompleteTodo": {
       "retry": {
         "maxAttempts": 3,
@@ -3009,6 +3148,17 @@
         "maxPageSize": 50
       }
     },
+    "CreateUploadVersion": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "GetVault": {
       "retry": {
         "maxAttempts": 3,

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

@@ -57,37 +57,52 @@ module Basecamp
         raise
       end
 
-      # Wraps a lazy Enumerator so operation hooks fire around actual iteration,
-      # not at enumerator creation time. Hooks fire when the consumer begins
-      # iterating (.each, .to_a, .first, etc.) and end fires via ensure when
-      # iteration completes, errors, or is cut short by break/take.
+      # Wraps a paginated operation with hooks, preserving the pagination
+      # metadata carried by the inner ListEnumerator.
+      # Fires on_operation_start eagerly (paginate fetches page 1 inside the
+      # yield, so the start hook must precede it); on_operation_end fires via
+      # ensure when the first traversal completes, errors, or is cut short by
+      # break/take — exactly once, so re-enumerating never emits an
+      # on_operation_end without a matching start.
       def wrap_paginated(service:, operation:, is_mutation: false, project_id: nil, resource_id: nil)
         info = OperationInfo.new(
           service: service, operation: operation,
           is_mutation: is_mutation, project_id: project_id, resource_id: resource_id
         )
-        enum = yield
-
         hooks = @hooks
-        Enumerator.new do |yielder|
-          start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        safe_hook { hooks.on_operation_start(info) }
+
+        begin
+          enum = yield  # paginate fetches page 1 here
+        rescue => e
+          duration = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).round
+          safe_hook { hooks.on_operation_end(info, OperationResult.new(duration_ms: duration, error: e)) }
+          raise
+        end
+
+        ended = false
+        ListEnumerator.new(enum.meta) do |yielder|
           error = nil
           begin
-            safe_hook { hooks.on_operation_start(info) }
             enum.each { |item| yielder.yield(item) }
           rescue => e
             error = e
             raise
           ensure
-            duration = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).round
-            safe_hook { hooks.on_operation_end(info, OperationResult.new(duration_ms: duration, error: error)) }
+            unless ended
+              ended = true
+              duration = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).round
+              safe_hook { hooks.on_operation_end(info, OperationResult.new(duration_ms: duration, error: error)) }
+            end
           end
         end
       end
 
       # Wraps a wrapped-paginated operation with hooks.
-      # Fires on_operation_start eagerly (before page 1 fetch),
-      # on_operation_end when the events Enumerator completes/errors/breaks.
+      # Fires on_operation_start eagerly (before page 1 fetch), and
+      # on_operation_end exactly once, when the first traversal of the events
+      # Enumerator completes/errors/breaks.
       def wrap_paginated_wrapped(key:, service:, operation:, is_mutation: false, project_id: nil, resource_id: nil)
         info = OperationInfo.new(
           service: service, operation: operation,
@@ -106,7 +121,8 @@ module Basecamp
         end
 
         inner_enum = result[key]
-        wrapped_enum = Enumerator.new do |yielder|
+        ended = false
+        wrapped_enum = ListEnumerator.new(inner_enum.meta) do |yielder|
           error = nil
           begin
             inner_enum.each { |item| yielder.yield(item) }
@@ -114,8 +130,13 @@ module Basecamp
             error = e
             raise
           ensure
-            duration = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).round
-            safe_hook { hooks.on_operation_end(info, OperationResult.new(duration_ms: duration, error: error)) }
+            # Exactly once: on_operation_start fired once at call time, so
+            # re-enumerating must not emit unmatched on_operation_end events.
+            unless ended
+              ended = true
+              duration = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).round
+              safe_hook { hooks.on_operation_end(info, OperationResult.new(duration_ms: duration, error: error)) }
+            end
           end
         end
 

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

@@ -8,12 +8,13 @@ module Basecamp
     class BookmarksService < BaseService
 
       # List the current user's bookmarks, most recently bookmarked first (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def list_my_bookmarks(page: nil)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def list_my_bookmarks(page: nil, max_items: nil)
         wrap_paginated(service: "bookmarks", operation: "list_my_bookmarks", is_mutation: false) do
           params = compact_query_params(page: page)
-          paginate("/my/bookmarks.json", params: params, operation: "ListMyBookmarks")
+          paginate("/my/bookmarks.json", params: params, operation: "ListMyBookmarks", max_items: max_items)
         end
       end