basecamp-sdk 0.12.0 → 0.13.0

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

@@ -11,12 +11,13 @@ module Basecamp
       # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
       #   Assignees on nested steps are not considered.
       # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_completed_cards(assignee_ids: nil, due: nil, 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 get_everything_completed_cards(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_completed_cards", is_mutation: false) do
           params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
-          paginate("/cards/completed.json", params: params, operation: "GetEverythingCompletedCards")
+          paginate("/cards/completed.json", params: params, operation: "GetEverythingCompletedCards", max_items: max_items)
         end
       end
 
@@ -24,12 +25,13 @@ module Basecamp
       # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
       #   Assignees on nested steps are not considered.
       # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_no_due_date_cards(assignee_ids: nil, due: nil, 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 get_everything_no_due_date_cards(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_no_due_date_cards", is_mutation: false) do
           params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
-          paginate("/cards/no_due_date.json", params: params, operation: "GetEverythingNoDueDateCards")
+          paginate("/cards/no_due_date.json", params: params, operation: "GetEverythingNoDueDateCards", max_items: max_items)
         end
       end
 
@@ -37,12 +39,13 @@ module Basecamp
       # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
       #   Assignees on nested steps are not considered.
       # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_not_now_cards(assignee_ids: nil, due: nil, 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 get_everything_not_now_cards(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_not_now_cards", is_mutation: false) do
           params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
-          paginate("/cards/not_now.json", params: params, operation: "GetEverythingNotNowCards")
+          paginate("/cards/not_now.json", params: params, operation: "GetEverythingNotNowCards", max_items: max_items)
         end
       end
 
@@ -50,12 +53,13 @@ module Basecamp
       # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
       #   Assignees on nested steps are not considered.
       # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_open_cards(assignee_ids: nil, due: nil, 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 get_everything_open_cards(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_open_cards", is_mutation: false) do
           params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
-          paginate("/cards/open.json", params: params, operation: "GetEverythingOpenCards")
+          paginate("/cards/open.json", params: params, operation: "GetEverythingOpenCards", max_items: max_items)
         end
       end
 
@@ -74,64 +78,70 @@ module Basecamp
       # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
       #   Assignees on nested steps are not considered.
       # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_unassigned_cards(assignee_ids: nil, due: nil, 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 get_everything_unassigned_cards(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_unassigned_cards", is_mutation: false) do
           params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
-          paginate("/cards/unassigned.json", params: params, operation: "GetEverythingUnassignedCards")
+          paginate("/cards/unassigned.json", params: params, operation: "GetEverythingUnassignedCards", max_items: max_items)
         end
       end
 
       # Get every automatic check-in answer across all accessible projects, newest-first.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_checkins(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 get_everything_checkins(page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_checkins", is_mutation: false) do
           params = compact_query_params(page: page)
-          paginate("/checkins.json", params: params, operation: "GetEverythingCheckins")
+          paginate("/checkins.json", params: params, operation: "GetEverythingCheckins", max_items: max_items)
         end
       end
 
       # Get every comment across all accessible projects, newest-first (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_comments(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 get_everything_comments(page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_comments", is_mutation: false) do
           params = compact_query_params(page: page)
-          paginate("/comments.json", params: params, operation: "GetEverythingComments")
+          paginate("/comments.json", params: params, operation: "GetEverythingComments", max_items: max_items)
         end
       end
 
       # Get every file recording across all accessible projects, newest-first (paginated).
       # @param kind [String, nil] Filter by file kind: all (default), images, pdfs, documents, or videos.
       # @param people_ids [Array, nil] Restrict to files created by the given people (repeatable).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_files(kind: nil, people_ids: nil, 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 get_everything_files(kind: nil, people_ids: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_files", is_mutation: false) do
           params = compact_query_params(kind: kind, people_ids: people_ids, page: page)
-          paginate("/files.json", params: params, operation: "GetEverythingFiles")
+          paginate("/files.json", params: params, operation: "GetEverythingFiles", max_items: max_items)
         end
       end
 
       # Get every inbox forward across all accessible projects, newest-first (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_forwards(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 get_everything_forwards(page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_forwards", is_mutation: false) do
           params = compact_query_params(page: page)
-          paginate("/forwards.json", params: params, operation: "GetEverythingForwards")
+          paginate("/forwards.json", params: params, operation: "GetEverythingForwards", max_items: max_items)
         end
       end
 
       # Get every message across all accessible projects, newest-first (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_messages(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 get_everything_messages(page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_messages", is_mutation: false) do
           params = compact_query_params(page: page)
-          paginate("/messages.json", params: params, operation: "GetEverythingMessages")
+          paginate("/messages.json", params: params, operation: "GetEverythingMessages", max_items: max_items)
         end
       end
 
@@ -139,12 +149,13 @@ module Basecamp
       # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
       #   Assignees on nested steps are not considered.
       # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_completed_todos(assignee_ids: nil, due: nil, 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 get_everything_completed_todos(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_completed_todos", is_mutation: false) do
           params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
-          paginate("/todos/completed.json", params: params, operation: "GetEverythingCompletedTodos")
+          paginate("/todos/completed.json", params: params, operation: "GetEverythingCompletedTodos", max_items: max_items)
         end
       end
 
@@ -152,12 +163,13 @@ module Basecamp
       # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
       #   Assignees on nested steps are not considered.
       # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_no_due_date_todos(assignee_ids: nil, due: nil, 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 get_everything_no_due_date_todos(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_no_due_date_todos", is_mutation: false) do
           params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
-          paginate("/todos/no_due_date.json", params: params, operation: "GetEverythingNoDueDateTodos")
+          paginate("/todos/no_due_date.json", params: params, operation: "GetEverythingNoDueDateTodos", max_items: max_items)
         end
       end
 
@@ -165,12 +177,13 @@ module Basecamp
       # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
       #   Assignees on nested steps are not considered.
       # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_open_todos(assignee_ids: nil, due: nil, 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 get_everything_open_todos(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_open_todos", is_mutation: false) do
           params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
-          paginate("/todos/open.json", params: params, operation: "GetEverythingOpenTodos")
+          paginate("/todos/open.json", params: params, operation: "GetEverythingOpenTodos", max_items: max_items)
         end
       end
 
@@ -189,12 +202,13 @@ module Basecamp
       # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
       #   Assignees on nested steps are not considered.
       # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_unassigned_todos(assignee_ids: nil, due: nil, 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 get_everything_unassigned_todos(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_unassigned_todos", is_mutation: false) do
           params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
-          paginate("/todos/unassigned.json", params: params, operation: "GetEverythingUnassignedTodos")
+          paginate("/todos/unassigned.json", params: params, operation: "GetEverythingUnassignedTodos", max_items: max_items)
         end
       end
     end

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

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for Folders operations
+    #
+    # @generated from OpenAPI spec
+    class FoldersService < BaseService
+
+      # List the authenticated user's folders in home-screen order.
+      # @return [Array<Hash>] response data
+      def list_folders()
+        with_operation(service: "folders", operation: "list_folders", is_mutation: false) do
+          http_get("/stacks.json", operation: "ListFolders").json
+        end
+      end
+
+      # Create a folder for the authenticated user and file the given projects into it.
+      # @param name [String, nil] The folder's name. Defaults to `New folder` when blank, null, or omitted.
+      # @param project_ids [Array, nil] IDs of the projects to file into the folder — the same ids the folder
+      #   reports back as `bucket_ids` and expands as `projects`. This does not
+      #   round-trip under its own name. Omit it, or send null or an empty array,
+      #   for an empty folder.
+      # @return [Hash] response data
+      def create_folder(name: nil, project_ids: nil)
+        with_operation(service: "folders", operation: "create_folder", is_mutation: true) do
+          http_post("/stacks.json", body: compact_params(name: name, project_ids: project_ids)).json
+        end
+      end
+
+      # Get one folder, with the projects grouped inside it expanded under `projects`.
+      # @param folder_id [Integer] folder id ID
+      # @return [Hash] response data
+      def get_folder(folder_id:)
+        with_operation(service: "folders", operation: "get_folder", is_mutation: false, resource_id: folder_id) do
+          http_get("/stacks/#{folder_id}", operation: "GetFolder").json
+        end
+      end
+
+      # Rename a folder.
+      # @param folder_id [Integer] folder id ID
+      # @param name [String] The folder's new name. Blank is rejected with 422 — unlike create, update
+      #   does not fall back to a default name.
+      # @return [Hash] response data
+      def update_folder(folder_id:, name:)
+        with_operation(service: "folders", operation: "update_folder", is_mutation: true, resource_id: folder_id) do
+          http_put("/stacks/#{folder_id}", body: compact_params(name: name)).json
+        end
+      end
+
+      # Delete a folder and unpin its projects from the home screen (returns 204 No Content).
+      # @param folder_id [Integer] folder id ID
+      # @return [void]
+      def delete_folder(folder_id:)
+        with_operation(service: "folders", operation: "delete_folder", is_mutation: true, resource_id: folder_id) do
+          http_delete("/stacks/#{folder_id}")
+          nil
+        end
+      end
+    end
+  end
+end

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

@@ -18,20 +18,13 @@ module Basecamp
 
       # List all replies to a forward
       # @param forward_id [Integer] forward id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list_replies(forward_id:)
+      # @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_replies(forward_id:, page: nil, max_items: nil)
         wrap_paginated(service: "forwards", operation: "list_replies", is_mutation: false, resource_id: forward_id) do
-          paginate("/inbox_forwards/#{forward_id}/replies.json", operation: "ListForwardReplies")
-        end
-      end
-
-      # Create a reply to a forward
-      # @param forward_id [Integer] forward id ID
-      # @param content [String] content
-      # @return [Hash] response data
-      def create_reply(forward_id:, content:)
-        with_operation(service: "forwards", operation: "create_reply", is_mutation: true, resource_id: forward_id) do
-          http_post("/inbox_forwards/#{forward_id}/replies.json", body: compact_params(content: content)).json
+          params = compact_query_params(page: page)
+          paginate("/inbox_forwards/#{forward_id}/replies.json", params: params, operation: "ListForwardReplies", max_items: max_items)
         end
       end
 
@@ -58,11 +51,13 @@ module Basecamp
       # @param inbox_id [Integer] inbox id ID
       # @param sort [String, nil] created_at|updated_at
       # @param direction [String, nil] asc|desc
-      # @return [Enumerator<Hash>] paginated results
-      def list(inbox_id:, sort: nil, direction: 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(inbox_id:, sort: nil, direction: nil, page: nil, max_items: nil)
         wrap_paginated(service: "forwards", operation: "list", is_mutation: false, resource_id: inbox_id) do
-          params = compact_query_params(sort: sort, direction: direction)
-          paginate("/inboxes/#{inbox_id}/forwards.json", params: params, operation: "ListForwards")
+          params = compact_query_params(sort: sort, direction: direction, page: page)
+          paginate("/inboxes/#{inbox_id}/inbox_forwards.json", params: params, operation: "ListForwards", max_items: max_items)
         end
       end
     end

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

@@ -49,10 +49,13 @@ module Basecamp
 
       # List gauge needles for a project, ordered newest first.
       # @param project_id [Integer] project id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list_gauge_needles(project_id:)
+      # @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_gauge_needles(project_id:, page: nil, max_items: nil)
         wrap_paginated(service: "gauges", operation: "list_gauge_needles", is_mutation: false, project_id: project_id) do
-          paginate("/projects/#{project_id}/gauge/needles.json", operation: "ListGaugeNeedles")
+          params = compact_query_params(page: page)
+          paginate("/projects/#{project_id}/gauge/needles.json", params: params, operation: "ListGaugeNeedles", max_items: max_items)
         end
       end
 
@@ -71,11 +74,13 @@ module Basecamp
       # List gauges across all projects the authenticated user has access to.
       # @param bucket_ids [String, nil] Comma-separated list of project IDs. When provided, results are returned
       #   in the order specified instead of by risk level.
-      # @return [Enumerator<Hash>] paginated results
-      def list_gauges(bucket_ids: 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_gauges(bucket_ids: nil, page: nil, max_items: nil)
         wrap_paginated(service: "gauges", operation: "list_gauges", is_mutation: false) do
-          params = compact_query_params(bucket_ids: bucket_ids)
-          paginate("/reports/gauges.json", params: params, operation: "ListGauges")
+          params = compact_query_params(bucket_ids: bucket_ids, page: page)
+          paginate("/reports/gauges.json", params: params, operation: "ListGauges", max_items: max_items)
         end
       end
     end

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

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for GoogleDocuments operations
+    #
+    # @generated from OpenAPI spec
+    class GoogleDocumentsService < BaseService
+
+      # Create a new Google document in a vault.
+      # @param bucket_id [Integer] bucket id ID
+      # @param vault_id [Integer] vault id ID
+      # @param url [String] url
+      # @param document_type [String] One of "doc", "sheet", "slide", "other". Backed by a Rails enum, so an
+      #   unrecognized value is rejected up front with a field-keyed 422
+      #   ({"errors": {"document_type": ["is not a valid document type"]}}) rather
+      #   than reaching validation.
+      # @param title [String, nil] title
+      # @param description [String, nil] description
+      # @param status [String, nil] active|drafted — defaults to drafted
+      # @param subscriptions [Array, nil] subscriptions
+      # @param visible_to_clients [Boolean, nil] Whether the document is visible to the project's clients. Applies only
+      #   when creating directly in the tool's vault — an item created inside a
+      #   folder inherits the folder's visibility and ignores this. A client caller
+      #   always creates client-visible records regardless of what is sent.
+      # @return [Hash] response data
+      def create_google_document(bucket_id:, vault_id:, url:, document_type:, title: nil, description: nil, status: nil, subscriptions: nil, visible_to_clients: nil)
+        with_operation(service: "googledocuments", operation: "create_google_document", is_mutation: true, project_id: bucket_id, resource_id: vault_id) do
+          http_post("/buckets/#{bucket_id}/vaults/#{vault_id}/google_documents.json", body: compact_params(url: url, document_type: document_type, title: title, description: description, status: status, subscriptions: subscriptions, visible_to_clients: visible_to_clients)).json
+        end
+      end
+
+      # Get a single Google document by id
+      # @param google_document_id [Integer] google document id ID
+      # @return [Hash] response data
+      def get_google_document(google_document_id:)
+        with_operation(service: "googledocuments", operation: "get_google_document", is_mutation: false, resource_id: google_document_id) do
+          http_get("/google_documents/#{google_document_id}", operation: "GetGoogleDocument").json
+        end
+      end
+
+      # Replace a Google document with a new complete representation.
+      # @param google_document_id [Integer] google document id ID
+      # @param url [String] url
+      # @param document_type [String] One of "doc", "sheet", "slide", "other". Backed by a Rails enum, so an
+      #   unrecognized value is rejected up front with a field-keyed 422
+      #   ({"errors": {"document_type": ["is not a valid document type"]}}) rather
+      #   than reaching validation.
+      # @param title [String, nil] title
+      # @param description [String, nil] description
+      # @param status [String, nil] active|drafted
+      # @param subscriptions [Array, nil] subscriptions
+      # @return [Hash] response data
+      def update_google_document(google_document_id:, url:, document_type:, title: nil, description: nil, status: nil, subscriptions: nil)
+        with_operation(service: "googledocuments", operation: "update_google_document", is_mutation: true, resource_id: google_document_id) do
+          http_put("/google_documents/#{google_document_id}", body: compact_params(url: url, document_type: document_type, title: title, description: description, status: status, subscriptions: subscriptions)).json
+        end
+      end
+    end
+  end
+end

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

@@ -9,10 +9,11 @@ module Basecamp
 
       # List message types in a project
       # @param bucket_id [Integer] bucket id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list(bucket_id:)
+      # @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(bucket_id:, max_items: nil)
         wrap_paginated(service: "messagetypes", operation: "list", is_mutation: false, project_id: bucket_id) do
-          paginate("/buckets/#{bucket_id}/categories.json", operation: "ListMessageTypes")
+          paginate("/buckets/#{bucket_id}/categories.json", operation: "ListMessageTypes", max_items: max_items)
         end
       end
 

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

@@ -11,11 +11,13 @@ module Basecamp
       # @param board_id [Integer] board id ID
       # @param sort [String, nil] created_at|updated_at
       # @param direction [String, nil] asc|desc
-      # @return [Enumerator<Hash>] paginated results
-      def list(board_id:, sort: nil, direction: 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(board_id:, sort: nil, direction: nil, page: nil, max_items: nil)
         wrap_paginated(service: "messages", operation: "list", is_mutation: false, resource_id: board_id) do
-          params = compact_query_params(sort: sort, direction: direction)
-          paginate("/message_boards/#{board_id}/messages.json", params: params, operation: "ListMessages")
+          params = compact_query_params(sort: sort, direction: direction, page: page)
+          paginate("/message_boards/#{board_id}/messages.json", params: params, operation: "ListMessages", max_items: max_items)
         end
       end
 

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

@@ -15,7 +15,7 @@ module Basecamp
         end
       end
 
-      # Replace the note's content, recording a new revision server-side. The first
+      # Replace the note's content, recording a new revision server-side.
       # @param note [Hash] note
       # @return [Hash] response data
       def update_my_note(note:)

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

@@ -8,7 +8,9 @@ module Basecamp
     class MyNotificationsService < BaseService
 
       # Get the current user's notification inbox (the "Hey!" menu).
-      # @param page [Integer, nil] Page number for paginating through read items. Defaults to 1.
+      # @param page [Integer, nil] Page number for paginating through read items. Defaults to 1. This
+      #   operation is not auto-paginated in any SDK, so a page is returned as
+      #   asked for and later pages are not followed.
       # @param limit_bubble_ups [Boolean, nil] Set to true to cap `bubble_ups` at 2 current bubble-ups and omit the
       #   `scheduled_bubble_ups` key entirely. Defaults to false. Use the dedicated
       #   bubble-ups endpoint (GetBubbleUps) to page through all current and
@@ -21,12 +23,13 @@ module Basecamp
       end
 
       # Get the current user's current and scheduled bubble-ups (paginated, 50 per page).
-      # @param page [Integer, nil] Page number. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_bubble_ups(page: nil)
+      # @param page [Integer, nil] Page number. 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 get_bubble_ups(page: nil, max_items: nil)
         wrap_paginated(service: "mynotifications", operation: "get_bubble_ups", is_mutation: false) do
           params = compact_query_params(page: page)
-          paginate("/my/readings/bubble_ups.json", params: params, operation: "GetBubbleUps")
+          paginate("/my/readings/bubble_ups.json", params: params, operation: "GetBubbleUps", max_items: max_items)
         end
       end
 

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

@@ -8,10 +8,11 @@ module Basecamp
     class PeopleService < BaseService
 
       # List all account users who can be pinged
-      # @return [Enumerator<Hash>] paginated results
-      def list_pingable()
+      # @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_pingable(max_items: nil)
         wrap_paginated(service: "people", operation: "list_pingable", is_mutation: false) do
-          paginate("/circles/people.json", operation: "ListPingablePeople")
+          paginate("/circles/people.json", operation: "ListPingablePeople", max_items: max_items)
         end
       end
 
@@ -23,7 +24,7 @@ module Basecamp
         end
       end
 
-      # Update the current user's preferences
+      # Update the current user's preferences.
       # @param person [Hash] person
       # @return [Hash] response data
       def update_my_preferences(person:)
@@ -58,10 +59,13 @@ module Basecamp
       end
 
       # List all people visible to the current user
-      # @return [Enumerator<Hash>] paginated results
-      def list()
+      # @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(page: nil, max_items: nil)
         wrap_paginated(service: "people", operation: "list", is_mutation: false) do
-          paginate("/people.json", operation: "ListPeople")
+          params = compact_query_params(page: page)
+          paginate("/people.json", params: params, operation: "ListPeople", max_items: max_items)
         end
       end
 
@@ -105,10 +109,13 @@ module Basecamp
 
       # List all active people on a project
       # @param project_id [Integer] project id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list_for_project(project_id:)
+      # @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_for_project(project_id:, page: nil, max_items: nil)
         wrap_paginated(service: "people", operation: "list_for_project", is_mutation: false, project_id: project_id) do
-          paginate("/projects/#{project_id}/people.json", operation: "ListProjectPeople")
+          params = compact_query_params(page: page)
+          paginate("/projects/#{project_id}/people.json", params: params, operation: "ListProjectPeople", max_items: max_items)
         end
       end