basecamp-sdk 0.2.1

data/lib/basecamp/services/schedules_service.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for schedule (calendar) operations.
+    #
+    # Schedules are calendars within projects that contain schedule entries (events).
+    # Each project has one schedule that can optionally show todo due dates.
+    #
+    # @example Get a schedule
+    #   schedule = account.schedules.get(project_id: 123, schedule_id: 456)
+    #
+    # @example List entries
+    #   account.schedules.list_entries(project_id: 123, schedule_id: 456).each do |entry|
+    #     puts "#{entry["summary"]} - #{entry["starts_at"]}"
+    #   end
+    #
+    # @example Create an entry
+    #   entry = account.schedules.create_entry(
+    #     project_id: 123,
+    #     schedule_id: 456,
+    #     summary: "Team Meeting",
+    #     starts_at: "2024-12-15T09:00:00Z",
+    #     ends_at: "2024-12-15T10:00:00Z"
+    #   )
+    class SchedulesService < BaseService
+      # Gets a specific schedule.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param schedule_id [Integer, String] schedule ID
+      # @return [Hash] schedule data
+      def get(project_id:, schedule_id:)
+        http_get(bucket_path(project_id, "/schedules/#{schedule_id}")).json
+      end
+
+      # Lists all entries on a schedule.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param schedule_id [Integer, String] schedule ID
+      # @return [Enumerator<Hash>] schedule entries
+      def list_entries(project_id:, schedule_id:)
+        paginate(bucket_path(project_id, "/schedules/#{schedule_id}/entries.json"))
+      end
+
+      # Gets a specific schedule entry.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param entry_id [Integer, String] schedule entry ID
+      # @return [Hash] schedule entry data
+      def get_entry(project_id:, entry_id:)
+        http_get(bucket_path(project_id, "/schedule_entries/#{entry_id}")).json
+      end
+
+      # Creates a new entry on a schedule.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param schedule_id [Integer, String] schedule ID
+      # @param summary [String] event title
+      # @param starts_at [String] start time in RFC3339 format
+      # @param ends_at [String] end time in RFC3339 format
+      # @param description [String, nil] event description in HTML
+      # @param participant_ids [Array<Integer>, nil] person IDs to assign
+      # @param all_day [Boolean, nil] whether this is an all-day event
+      # @param notify [Boolean, nil] whether to notify participants
+      # @return [Hash] created entry
+      def create_entry(
+        project_id:,
+        schedule_id:,
+        summary:,
+        starts_at:,
+        ends_at:,
+        description: nil,
+        participant_ids: nil,
+        all_day: nil,
+        notify: nil
+      )
+        body = compact_params(
+          summary: summary,
+          starts_at: starts_at,
+          ends_at: ends_at,
+          description: description,
+          participant_ids: participant_ids,
+          all_day: all_day,
+          notify: notify
+        )
+        http_post(bucket_path(project_id, "/schedules/#{schedule_id}/entries.json"), body: body).json
+      end
+
+      # Updates an existing schedule entry.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param entry_id [Integer, String] schedule entry ID
+      # @param summary [String, nil] new title
+      # @param starts_at [String, nil] new start time in RFC3339 format
+      # @param ends_at [String, nil] new end time in RFC3339 format
+      # @param description [String, nil] new description in HTML
+      # @param participant_ids [Array<Integer>, nil] new participant IDs
+      # @param all_day [Boolean, nil] whether this is an all-day event
+      # @param notify [Boolean, nil] whether to notify participants
+      # @return [Hash] updated entry
+      def update_entry(
+        project_id:,
+        entry_id:,
+        summary: nil,
+        starts_at: nil,
+        ends_at: nil,
+        description: nil,
+        participant_ids: nil,
+        all_day: nil,
+        notify: nil
+      )
+        body = compact_params(
+          summary: summary,
+          starts_at: starts_at,
+          ends_at: ends_at,
+          description: description,
+          participant_ids: participant_ids,
+          all_day: all_day,
+          notify: notify
+        )
+        http_put(bucket_path(project_id, "/schedule_entries/#{entry_id}"), body: body).json
+      end
+
+      # Gets a specific occurrence of a recurring schedule entry.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param entry_id [Integer, String] schedule entry ID
+      # @param date [String] occurrence date in YYYY-MM-DD format
+      # @return [Hash] schedule entry occurrence
+      def get_entry_occurrence(project_id:, entry_id:, date:)
+        http_get(bucket_path(project_id, "/schedule_entries/#{entry_id}/occurrences/#{date}")).json
+      end
+
+      # Updates schedule settings.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param schedule_id [Integer, String] schedule ID
+      # @param include_due_assignments [Boolean] whether to show todo due dates
+      # @return [Hash] updated schedule
+      def update_settings(project_id:, schedule_id:, include_due_assignments:)
+        body = { include_due_assignments: include_due_assignments }
+        http_put(bucket_path(project_id, "/schedules/#{schedule_id}"), body: body).json
+      end
+
+      # Moves a schedule entry to the trash.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param entry_id [Integer, String] schedule entry ID
+      # @return [void]
+      def trash_entry(project_id:, entry_id:)
+        http_put(bucket_path(project_id, "/recordings/#{entry_id}/status/trashed.json"))
+        nil
+      end
+    end
+  end
+end

data/lib/basecamp/services/search_service.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for search operations.
+    #
+    # Provides full-text search across all content in your Basecamp account.
+    #
+    # @example Search for content
+    #   results = account.search.search(query: "quarterly report")
+    #   results.each { |r| puts r["title"] }
+    #
+    # @example Get search metadata
+    #   metadata = account.search.metadata
+    #   puts "Available projects: #{metadata["projects"].length}"
+    class SearchService < BaseService
+      # Searches for content across the account.
+      #
+      # @param query [String] the search query string
+      # @param sort [String, nil] sort order ("created_at" or "updated_at")
+      # @return [Enumerator<Hash>] search results
+      def search(query:, sort: nil)
+        params = compact_params(query: query, sort: sort)
+        paginate("/search.json", params: params)
+      end
+
+      # Returns metadata about available search scopes.
+      # This includes the list of projects available for filtering.
+      #
+      # @return [Hash] search metadata with available filter options
+      def metadata
+        http_get("/searches/metadata.json").json
+      end
+    end
+  end
+end

data/lib/basecamp/services/subscriptions_service.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for subscription operations.
+    #
+    # Subscriptions control who receives notifications for a specific recording
+    # (like a todo, message, or comment). Users can subscribe or unsubscribe
+    # themselves, and you can batch update subscriptions for multiple users.
+    #
+    # @example Get subscription info
+    #   subscription = account.subscriptions.get(project_id: 123, recording_id: 456)
+    #   puts "Subscribed: #{subscription["subscribed"]}, Count: #{subscription["count"]}"
+    #
+    # @example Batch update subscriptions
+    #   account.subscriptions.update(
+    #     project_id: 123,
+    #     recording_id: 456,
+    #     subscriptions: [user_id_1, user_id_2],
+    #     unsubscriptions: [user_id_3]
+    #   )
+    class SubscriptionsService < BaseService
+      # Gets the subscription information for a recording.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param recording_id [Integer, String] recording ID
+      # @return [Hash] subscription info with subscribed, count, subscribers
+      def get(project_id:, recording_id:)
+        http_get(bucket_path(project_id, "/recordings/#{recording_id}/subscription.json")).json
+      end
+
+      # Subscribes the current user to the recording.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param recording_id [Integer, String] recording ID
+      # @return [Hash] updated subscription information
+      def subscribe(project_id:, recording_id:)
+        http_post(bucket_path(project_id, "/recordings/#{recording_id}/subscription.json")).json
+      end
+
+      # Unsubscribes the current user from the recording.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param recording_id [Integer, String] recording ID
+      # @return [void]
+      def unsubscribe(project_id:, recording_id:)
+        http_delete(bucket_path(project_id, "/recordings/#{recording_id}/subscription.json"))
+        nil
+      end
+
+      # Batch modifies subscriptions by adding or removing specific users.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param recording_id [Integer, String] recording ID
+      # @param subscriptions [Array<Integer>, nil] person IDs to subscribe
+      # @param unsubscriptions [Array<Integer>, nil] person IDs to unsubscribe
+      # @return [Hash] updated subscription information
+      def update(project_id:, recording_id:, subscriptions: nil, unsubscriptions: nil)
+        body = compact_params(
+          subscriptions: subscriptions,
+          unsubscriptions: unsubscriptions
+        )
+        http_put(bucket_path(project_id, "/recordings/#{recording_id}/subscription.json"), body: body).json
+      end
+    end
+  end
+end

data/lib/basecamp/services/templates_service.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for template operations.
+    #
+    # Templates allow you to create reusable project structures.
+    #
+    # @example List templates
+    #   account.templates.list.each do |template|
+    #     puts template["name"]
+    #   end
+    #
+    # @example Create a project from template
+    #   construction = account.templates.create_project(
+    #     template_id: 123,
+    #     name: "Q1 Planning"
+    #   )
+    class TemplatesService < BaseService
+      # Lists all templates visible to the current user.
+      #
+      # @return [Enumerator<Hash>] templates
+      def list
+        paginate("/templates.json")
+      end
+
+      # Gets a template by ID.
+      #
+      # @param template_id [Integer, String] template ID
+      # @return [Hash] template data
+      def get(template_id:)
+        http_get("/templates/#{template_id}").json
+      end
+
+      # Creates a new template.
+      #
+      # @param name [String] template name
+      # @param description [String, nil] template description
+      # @return [Hash] created template
+      def create(name:, description: nil)
+        body = compact_params(
+          name: name,
+          description: description
+        )
+        http_post("/templates.json", body: body).json
+      end
+
+      # Updates an existing template.
+      #
+      # @param template_id [Integer, String] template ID
+      # @param name [String] new name
+      # @param description [String, nil] new description
+      # @return [Hash] updated template
+      def update(template_id:, name:, description: nil)
+        body = compact_params(
+          name: name,
+          description: description
+        )
+        http_put("/templates/#{template_id}", body: body).json
+      end
+
+      # Deletes a template.
+      #
+      # @param template_id [Integer, String] template ID
+      # @return [void]
+      def delete(template_id:)
+        http_delete("/templates/#{template_id}")
+        nil
+      end
+
+      # Creates a new project from a template.
+      # This operation is asynchronous. Use get_construction to check status.
+      #
+      # @param template_id [Integer, String] template ID
+      # @param name [String] project name
+      # @param description [String, nil] project description
+      # @return [Hash] project construction status
+      def create_project(template_id:, name:, description: nil)
+        body = compact_params(
+          name: name,
+          description: description
+        )
+        http_post("/templates/#{template_id}/project_constructions.json", body: body).json
+      end
+
+      # Gets the status of a project construction.
+      #
+      # @param template_id [Integer, String] template ID
+      # @param construction_id [Integer, String] construction ID
+      # @return [Hash] project construction status
+      def get_construction(template_id:, construction_id:)
+        http_get("/templates/#{template_id}/project_constructions/#{construction_id}").json
+      end
+    end
+  end
+end

data/lib/basecamp/services/timeline_service.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for timeline and progress report operations.
+    #
+    # Provides access to activity feeds showing recent activity across the account,
+    # within specific projects, or for specific people.
+    #
+    # @example Get account-wide progress report
+    #   account.timeline.progress.each { |event| puts event["action"] }
+    #
+    # @example Get project timeline
+    #   account.timeline.project_timeline(project_id: 123).each { |event| puts event }
+    #
+    # @example Get a person's progress (returns hash with person info)
+    #   result = account.timeline.person_progress(person_id: 456)
+    #   puts result["person"]["name"]
+    #   result["events"].each { |event| puts event["action"] }
+    class TimelineService < BaseService
+      # Returns the account-wide progress report.
+      # This shows recent activity across all projects.
+      # Results are paginated via Link header.
+      #
+      # @return [Enumerator<Hash>] timeline events
+      def progress
+        paginate_key("/reports/progress.json", key: "events")
+      end
+
+      # Returns the activity timeline for a specific project.
+      # Results are paginated via Link header.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @return [Enumerator<Hash>] timeline events
+      def project_timeline(project_id:)
+        paginate_key(bucket_path(project_id, "/timeline.json"), key: "events")
+      end
+
+      # Returns the progress report for a specific person, including person metadata.
+      #
+      # @note Returns first page only to preserve person metadata.
+      #       Use {#person_progress_events} for full paginated event stream.
+      # @param person_id [Integer, String] person ID
+      # @return [Hash] object with "person" and "events" keys
+      def person_progress(person_id:)
+        response = http_get("/reports/users/progress/#{person_id}")
+        response.json
+      end
+
+      # Returns all progress events for a specific person.
+      # Results are paginated via Link header.
+      #
+      # @note Does not include person metadata. Use {#person_progress} if you need
+      #       the person object along with the first page of events.
+      # @param person_id [Integer, String] person ID
+      # @return [Enumerator<Hash>] timeline events
+      def person_progress_events(person_id:)
+        paginate_key("/reports/users/progress/#{person_id}", key: "events")
+      end
+    end
+  end
+end

data/lib/basecamp/services/timesheet_service.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for timesheet report operations.
+    #
+    # Provides access to timesheet reports at account, project, and recording levels.
+    # Supports filtering by date range and person.
+    #
+    # @example Get account-wide timesheet
+    #   result = account.timesheet.report
+    #   result["entries"].each { |e| puts e["hours"] }
+    #
+    # @example Get project timesheet with filters
+    #   result = account.timesheet.project_report(
+    #     project_id: 123,
+    #     from: "2024-01-01",
+    #     to: "2024-01-31"
+    #   )
+    #
+    # @example Get timesheet for a specific todo
+    #   result = account.timesheet.recording_report(
+    #     project_id: 123,
+    #     recording_id: 789
+    #   )
+    class TimesheetService < BaseService
+      # Returns the account-wide timesheet report.
+      # This includes time entries across all projects in the account.
+      #
+      # @param from [String, nil] filter entries on or after this date (ISO 8601, e.g., "2024-01-01")
+      # @param to [String, nil] filter entries on or before this date (ISO 8601, e.g., "2024-01-31")
+      # @param person_id [Integer, nil] filter entries by a specific person
+      # @return [Hash] timesheet report object with "entries" array
+      def report(from: nil, to: nil, person_id: nil)
+        params = compact_params(from: from, to: to, person_id: person_id)
+        response = http_get("/reports/timesheet.json", params: params)
+        response.json
+      end
+
+      # Returns the timesheet report for a specific project.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param from [String, nil] filter entries on or after this date (ISO 8601)
+      # @param to [String, nil] filter entries on or before this date (ISO 8601)
+      # @param person_id [Integer, nil] filter entries by a specific person
+      # @return [Hash] timesheet report object with "entries" array
+      def project_report(project_id:, from: nil, to: nil, person_id: nil)
+        params = compact_params(from: from, to: to, person_id: person_id)
+        response = http_get(bucket_path(project_id, "/timesheet.json"), params: params)
+        response.json
+      end
+
+      # Returns the timesheet report for a specific recording within a project.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param recording_id [Integer, String] recording ID (e.g., a todo)
+      # @param from [String, nil] filter entries on or after this date (ISO 8601)
+      # @param to [String, nil] filter entries on or before this date (ISO 8601)
+      # @param person_id [Integer, nil] filter entries by a specific person
+      # @return [Hash] timesheet report object with "entries" array
+      def recording_report(project_id:, recording_id:, from: nil, to: nil, person_id: nil)
+        params = compact_params(from: from, to: to, person_id: person_id)
+        response = http_get(bucket_path(project_id, "/recordings/#{recording_id}/timesheet.json"), params: params)
+        response.json
+      end
+    end
+  end
+end

data/lib/basecamp/services/todolist_groups_service.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for todolist group operations.
+    #
+    # Todolist groups are organizational folders within a todolist that help
+    # organize related todos together.
+    #
+    # @example List groups in a todolist
+    #   groups = account.todolist_groups.list(project_id: 123, todolist_id: 456)
+    #
+    # @example Create a new group
+    #   group = account.todolist_groups.create(
+    #     project_id: 123,
+    #     todolist_id: 456,
+    #     name: "Phase 1"
+    #   )
+    #
+    # @example Update a group name
+    #   group = account.todolist_groups.update(
+    #     project_id: 123,
+    #     group_id: 789,
+    #     name: "Phase 1 - Complete"
+    #   )
+    class TodolistGroupsService < BaseService
+      # Lists all groups in a todolist.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param todolist_id [Integer, String] todolist ID
+      # @return [Enumerator<Hash>] todolist groups
+      def list(project_id:, todolist_id:)
+        paginate(bucket_path(project_id, "/todolists/#{todolist_id}/groups.json"))
+      end
+
+      # Gets a specific todolist group.
+      #
+      # Note: Groups are fetched via the todolists endpoint (polymorphic).
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param group_id [Integer, String] group ID
+      # @return [Hash] group data
+      def get(project_id:, group_id:)
+        http_get(bucket_path(project_id, "/todolists/#{group_id}.json")).json
+      end
+
+      # Creates a new group in a todolist.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param todolist_id [Integer, String] todolist ID
+      # @param name [String] group name (required)
+      # @return [Hash] created group
+      # @raise [ArgumentError] if name is empty
+      def create(project_id:, todolist_id:, name:)
+        raise ArgumentError, "group name is required" if name.nil? || name.empty?
+
+        body = { name: name }
+        http_post(bucket_path(project_id, "/todolists/#{todolist_id}/groups.json"), body: body).json
+      end
+
+      # Updates an existing todolist group.
+      #
+      # Note: Groups are updated via the todolists endpoint (polymorphic).
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param group_id [Integer, String] group ID
+      # @param name [String, nil] new group name
+      # @return [Hash] updated group
+      def update(project_id:, group_id:, name: nil)
+        body = compact_params(name: name)
+        http_put(bucket_path(project_id, "/todolists/#{group_id}.json"), body: body).json
+      end
+
+      # Repositions a group within its todolist.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param group_id [Integer, String] group ID
+      # @param position [Integer] new position (1-based, 1 = first position)
+      # @return [void]
+      # @raise [ArgumentError] if position is less than 1
+      def reposition(project_id:, group_id:, position:)
+        raise ArgumentError, "position must be at least 1" if position < 1
+
+        http_put(bucket_path(project_id, "/todolists/#{group_id}/position.json"), body: { position: position })
+        nil
+      end
+
+      # Moves a group to the trash.
+      # Trashed groups can be recovered from the trash.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param group_id [Integer, String] group ID
+      # @return [void]
+      def trash(project_id:, group_id:)
+        http_put(bucket_path(project_id, "/recordings/#{group_id}/status/trashed.json"))
+        nil
+      end
+    end
+  end
+end

data/lib/basecamp/services/todolists_service.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for todolist operations.
+    #
+    # Todolists are collections of todos within a todoset. A project has one
+    # todoset which contains multiple todolists.
+    #
+    # @example List todolists
+    #   account.todolists.list(project_id: 123, todoset_id: 456).each do |list|
+    #     puts "#{list["name"]} - #{list["completed_ratio"]}"
+    #   end
+    #
+    # @example Create a todolist
+    #   todolist = account.todolists.create(
+    #     project_id: 123,
+    #     todoset_id: 456,
+    #     name: "Launch Tasks"
+    #   )
+    class TodolistsService < BaseService
+      # Lists all todolists in a todoset.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param todoset_id [Integer, String] todoset ID
+      # @param status [String, nil] filter by status ("archived", "trashed")
+      # @return [Enumerator<Hash>] todolists
+      def list(project_id:, todoset_id:, status: nil)
+        params = compact_params(status: status)
+        paginate(bucket_path(project_id, "/todosets/#{todoset_id}/todolists.json"), params: params)
+      end
+
+      # Gets a specific todolist.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param todolist_id [Integer, String] todolist ID
+      # @return [Hash] todolist data
+      def get(project_id:, todolist_id:)
+        http_get(bucket_path(project_id, "/todolists/#{todolist_id}")).json
+      end
+
+      # Creates a new todolist.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param todoset_id [Integer, String] todoset ID
+      # @param name [String] todolist name
+      # @param description [String, nil] todolist description in HTML
+      # @return [Hash] created todolist
+      def create(project_id:, todoset_id:, name:, description: nil)
+        body = compact_params(
+          name: name,
+          description: description
+        )
+        http_post(bucket_path(project_id, "/todosets/#{todoset_id}/todolists.json"), body: body).json
+      end
+
+      # Updates a todolist.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param todolist_id [Integer, String] todolist ID
+      # @param name [String, nil] new name
+      # @param description [String, nil] new description
+      # @return [Hash] updated todolist
+      def update(project_id:, todolist_id:, name: nil, description: nil)
+        body = compact_params(
+          name: name,
+          description: description
+        )
+        http_put(bucket_path(project_id, "/todolists/#{todolist_id}"), body: body).json
+      end
+
+      # Lists all todolist groups within a todolist.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param todolist_id [Integer, String] todolist ID
+      # @return [Enumerator<Hash>] todolist groups
+      def list_groups(project_id:, todolist_id:)
+        paginate(bucket_path(project_id, "/todolists/#{todolist_id}/groups.json"))
+      end
+
+      # Creates a new todolist group.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param todolist_id [Integer, String] todolist ID
+      # @param name [String] group name
+      # @return [Hash] created group
+      def create_group(project_id:, todolist_id:, name:)
+        body = { name: name }
+        http_post(bucket_path(project_id, "/todolists/#{todolist_id}/groups.json"), body: body).json
+      end
+
+      # Repositions a todolist group.
+      #
+      # @param project_id [Integer, String] project (bucket) ID
+      # @param todolist_id [Integer, String] todolist ID (the group's ID)
+      # @param position [Integer] new position (1-based)
+      # @return [void]
+      def reposition_group(project_id:, todolist_id:, position:)
+        http_put(bucket_path(project_id, "/todolists/#{todolist_id}/position.json"), body: { position: position })
+        nil
+      end
+    end
+  end
+end