bloomy 0.10.0 → 0.11.5

data/lib/bloomy/operations/issues.rb

@@ -3,112 +3,96 @@
 require "json"
 require "bloomy/utils/get_user_id"
 
-# Class to handle all the operations related to issues
-class Issue
-  include Bloomy::Utilities::UserIdUtility
-  # Initializes a new Issue instance
-  #
-  # @param conn [Object] the connection object to interact with the API
-  def initialize(conn)
-    @conn = conn
-  end
-
-  # Retrieves details of a specific issue
-  #
-  # @param issue_id [Integer] the ID of the issue
-  # @return [Hash] a hash containing issue details
-  # @example
-  #   issue.details(123)
-  #   #=> { id: 123, title: "Issue Title", notes_url: "http://details.url", ... }
-  def details(issue_id)
-    response = @conn.get("issues/#{issue_id}").body
-    {
-      id: response["Id"],
-      title: response["Name"],
-      notes_url: response["DetailsUrl"],
-      created_at: response["CreateTime"],
-      completed_at: response["CloseTime"],
-      meeting_details: {
-        id: response["OriginId"],
-        title: response["Origin"]
-      },
-      owner_details: {
-        id: response["Owner"]["Id"],
-        name: response["Owner"]["Name"]
-      }
-    }
-  end
+module Bloomy
+  # Handles CRUD operations for issues in the system.
+  # Provides functionality to create, retrieve, list, and solve issues
+  # associated with meetings and users.
+  class Issue
+    include Bloomy::Utilities::UserIdUtility
 
-  # Lists issues for a specific user or meeting
-  #
-  # @param user_id [Integer, nil] the ID of the user (defaults to initialized user_id)
-  # @param meeting_id [Integer, nil] the ID of the meeting
-  # @raise [ArgumentError] if both `user_id` and `meeting_id` are provided
-  # @return [Array<Hash>] an array of hashes containing issues details
-  # @example
-  #   # Fetch issues for the current user
-  #   issue.list
-  #
-  #   # Fetch issues for a specific user
-  #   issue.list(user_id: 42)
-  #
-  #   # Fetch issues for a specific meeting
-  #   issue.list(meeting_id: 99)
-  def list(user_id: nil, meeting_id: nil)
-    if user_id && meeting_id
-      raise ArgumentError, "Please provide either `user_id` or `meeting_id`, not both."
+    # Initializes a new Issue instance
+    #
+    # @param conn [Faraday::Connection] Connection object for making API requests
+    # @return [Issue] New instance of Issue
+    def initialize(conn)
+      @conn = conn
     end
 
-    if meeting_id
-      response = @conn.get("l10/#{meeting_id}/issues").body
-    else
-      user_id ||= self.user_id
-      response = @conn.get("issues/users/#{user_id}").body
+    # Retrieves detailed information about a specific issue
+    #
+    # @param issue_id [Integer] Unique identifier of the issue
+    # @return [Types::IssueDetails] Detailed information about the issue
+    # @raise [ApiError] When the API request fails or returns invalid data
+    def details(issue_id)
+      response = @conn.get("issues/#{issue_id}").body
+      Types::IssueItem.new(
+        id: response["Id"],
+        title: response["Name"],
+        notes_url: response["DetailsUrl"],
+        created_at: response["CreateTime"],
+        completed_at: response["CloseTime"],
+        meeting_id: response["OriginId"],
+        meeting_title: response["Origin"],
+        user_id: response["Owner"]["Id"],
+        user_name: response["Owner"]["Name"]
+      )
     end
 
-    response.map do |issue|
-      {
-        id: issue["Id"],
-        title: issue["Name"],
-        notes_url: issue["DetailsUrl"],
-        created_at: issue["CreateTime"],
-        meeting_id: issue["OriginId"],
-        meeting_title: issue["Origin"]
-      }
+    # Lists issues filtered by user or meeting
+    #
+    # @param user_id [Integer, nil] Unique identifier of the user (optional)
+    # @param meeting_id [Integer, nil] Unique identifier of the meeting (optional)
+    # @return [Array<Types::IssueItem>] List of issues matching the filter criteria
+    # @raise [ArgumentError] When both user_id and meeting_id are provided
+    # @raise [ApiError] When the API request fails or returns invalid data
+    def list(user_id: nil, meeting_id: nil)
+      if user_id && meeting_id
+        raise ArgumentError, "Please provide either `user_id` or `meeting_id`, not both."
+      end
+
+      response = meeting_id ? @conn.get("l10/#{meeting_id}/issues").body : @conn.get("issues/users/#{user_id || self.user_id}").body
+
+      response.map do |issue|
+        Types::IssueItem.new(
+          id: issue["Id"],
+          title: issue["Name"],
+          notes_url: issue["DetailsUrl"],
+          created_at: issue["CreateTime"],
+          meeting_id: issue["OriginId"],
+          meeting_title: issue["Origin"]
+        )
+      end
     end
-  end
 
-  # Marks an issue as solved
-  #
-  # @param issue_id [Integer] the ID of the issue
-  # @return [Boolean] true if the operation was successful, false otherwise
-  # @example
-  #   issue.solve(123)
-  #   #=> true
-  def solve(issue_id)
-    response = @conn.post("issues/#{issue_id}/complete", {complete: true}.to_json)
-    response.success?
-  end
+    # Marks an issue as completed/solved
+    #
+    # @param issue_id [Integer] Unique identifier of the issue to be solved
+    # @return [Boolean] true if issue was successfully solved, false otherwise
+    # @raise [ApiError] When the API request fails
+    def solve(issue_id)
+      response = @conn.post("issues/#{issue_id}/complete", {complete: true}.to_json)
+      response.success?
+    end
 
-  # Creates a new issue
-  #
-  # @param meeting_id [Integer] the ID of the meeting associated with the issue
-  # @param title [String] the title of the new issue
-  # @param user_id [Integer] the ID of the user responsible for the issue (default: initialized user ID)
-  # @param notes [String, nil] the notes for the issue (optional)
-  # @return [Hash] a hash containing the new issue's ID and title
-  # @example
-  #   issue.create(meeting_id: 123, title: "New Issue")
-  #   #=> { id: 789, title: "New Issue" }
-  def create(meeting_id:, title:, user_id: self.user_id, notes: nil)
-    response = @conn.post("issues/create", {title: title, meetingid: meeting_id, ownerid: user_id, notes: notes}.to_json)
-    {
-      id: response.body["Id"],
-      meeting_id: response.body["OriginId"],
-      meeting_title: response.body["Origin"],
-      title: response.body["Name"],
-      user_id: response.body["Owner"]["Id"],
-      notes_url: response.body["DetailsUrl"]
-    }
+    # Creates a new issue in the system
+    #
+    # @param meeting_id [Integer] Unique identifier of the associated meeting
+    # @param title [String] Title/name of the issue
+    # @param user_id [Integer] Unique identifier of the issue owner (defaults to current user)
+    # @param notes [String, nil] Additional notes or description for the issue (optional)
+    # @return [Types::IssueItem] Newly created issue details
+    # @raise [ApiError] When the API request fails or returns invalid data
+    # @raise [ArgumentError] When required parameters are missing or invalid
+    def create(meeting_id:, title:, user_id: self.user_id, notes: nil)
+      response = @conn.post("issues/create", {title: title, meetingid: meeting_id, ownerid: user_id, notes: notes}.to_json)
+      Types::IssueItem.new(
+        id: response.body["Id"],
+        meeting_id: response.body["OriginId"],
+        meeting_title: response.body["Origin"],
+        title: response.body["Name"],
+        user_id: response.body["Owner"]["Id"],
+        notes_url: response.body["DetailsUrl"]
+      )
+    end
   end
 end

data/lib/bloomy/operations/meetings.rb

@@ -2,171 +2,173 @@
 
 require "bloomy/utils/get_user_id"
 
-# Class to handle all the operations related to meeting
-# @note
-#   This class is already initialized via the client and usable as `client.measurable.method`
-class Meeting
-  include Bloomy::Utilities::UserIdUtility
-  # Initializes a new Meeting instance
-  #
-  # @param conn [Object] the connection object to interact with the API
-  def initialize(conn)
-    @conn = conn
-  end
+module Bloomy
+  # Class to handle all the operations related to meeting
+  # @note
+  #   This class is already initialized via the client and usable as `client.meeting.method`
+  class Meeting
+    include Bloomy::Utilities::UserIdUtility
+    # Initializes a new Meeting instance
+    #
+    # @param conn [Object] the connection object to interact with the API
+    def initialize(conn)
+      @conn = conn
+    end
 
-  # Lists all meetings for a specific user
-  #
-  # @param user_id [Integer] the ID of the user (default is the initialized user ID)
-  # @return [Array<Hash>] an array of hashes containing meeting details
-  # @example
-  #   client.meeting.list
-  #   #=> [{ id: 123, name: "Team Meeting" }, ...]
-  def list(user_id = self.user_id)
-    response = @conn.get("L10/#{user_id}/list").body
-    response.map { |meeting| {id: meeting["Id"], name: meeting["Name"]} }
-  end
+    # Lists all meetings for a specific user
+    #
+    # @param user_id [Integer] the ID of the user (default is the initialized user ID)
+    # @return [Array<Hash>] an array of hashes containing meeting details
+    # @example
+    #   client.meeting.list
+    #   #=> [{ id: 123, name: "Team Meeting" }, ...]
+    def list(user_id = self.user_id)
+      response = @conn.get("L10/#{user_id}/list").body
+      response.map { |meeting| Types::MeetingItem.new(id: meeting["Id"], title: meeting["Name"]) }
+    end
 
-  # Lists all attendees for a specific meeting
-  #
-  # @param meeting_id [Integer] the ID of the meeting
-  # @return [Array<Hash>] an array of hashes containing attendee details
-  # @example
-  #   client.meeting.attendees(1)
-  #   #=> [{ name: "John Doe", id: 1 }, ...]
-  def attendees(meeting_id)
-    response = @conn.get("L10/#{meeting_id}/attendees").body
-    response.map { |attendee| {name: attendee["Name"], id: attendee["Id"]} }
-  end
+    # Lists all attendees for a specific meeting
+    #
+    # @param meeting_id [Integer] the ID of the meeting
+    # @return [Array<Hash>] an array of hashes containing attendee details
+    # @example
+    #   client.meeting.attendees(1)
+    #   #=> [{ name: "John Doe", id: 1 }, ...]
+    def attendees(meeting_id)
+      response = @conn.get("L10/#{meeting_id}/attendees").body
+      response.map { |attendee| Types::UserItem.new(id: attendee["Id"], name: attendee["Name"]) }
+    end
 
-  # Lists all issues for a specific meeting
-  #
-  # @param meeting_id [Integer] the ID of the meeting
-  # @param include_closed [Boolean] whether to include closed issues (default: false)
-  # @return [Array<Hash>] an array of hashes containing issue details
-  # @example
-  #   client.meeting.issues(1)
-  #   #=> [{ id: 1, title: "Issue Title", created_at: "2024-06-10", ... }, ...]
-  def issues(meeting_id, include_closed: false)
-    response = @conn.get("L10/#{meeting_id}/issues?include_resolved=#{include_closed}").body
-    response.map do |issue|
-      {
-        id: issue["Id"],
-        title: issue["Name"],
-        created_at: issue["CreateTime"],
-        closed_at: issue["CloseTime"],
-        details_url: issue["DetailsUrl"],
-        owner: {
-          id: issue["Owner"]["Id"],
-          name: issue["Owner"]["Name"]
-        }
-      }
+    # Lists all issues for a specific meeting
+    #
+    # @param meeting_id [Integer] the ID of the meeting
+    # @param include_closed [Boolean] whether to include closed issues (default: false)
+    # @return [Array<Hash>] an array of hashes containing issue details
+    # @example
+    #   client.meeting.issues(1)
+    #   #=> [{ id: 1, title: "Issue Title", created_at: "2024-06-10", ... }, ...]
+    def issues(meeting_id, include_closed: false)
+      response = @conn.get("L10/#{meeting_id}/issues?include_resolved=#{include_closed}").body
+      response.map do |issue|
+        Types::IssueItem.new(
+          id: issue["Id"],
+          title: issue["Name"],
+          notes_url: issue["DetailsUrl"],
+          created_at: issue["CreateTime"],
+          completed_at: issue["CloseTime"],
+          user_id: issue.dig("Owner", "Id"),
+          user_name: issue.dig("Owner", "Name"),
+          meeting_id: meeting_id,
+          meeting_title: issue["Origin"]
+        )
+      end
     end
-  end
 
-  # Lists all todos for a specific meeting
-  #
-  # @param meeting_id [Integer] the ID of the meeting
-  # @param include_closed [Boolean] whether to include closed todos (default: false)
-  # @return [Array<Hash>] an array of hashes containing todo details
-  # @example
-  #   client.meeting.todos(1)
-  #   #=> [{ id: 1, title: "Todo Title", due_date: "2024-06-12", ... }, ...]
-  def todos(meeting_id, include_closed: false)
-    response = @conn.get("L10/#{meeting_id}/todos?INCLUDE_CLOSED=#{include_closed}").body
-    response.map do |todo|
-      {
-        id: todo["Id"],
-        title: todo["Name"],
-        due_date: todo["DueDate"],
-        details_url: todo["DetailsUrl"],
-        completed_at: todo["CompleteTime"],
-        owner: {
-          id: todo["Owner"]["Id"],
-          name: todo["Owner"]["Name"]
-        }
-      }
+    # Lists all todos for a specific meeting
+    #
+    # @param meeting_id [Integer] the ID of the meeting
+    # @param include_closed [Boolean] whether to include closed todos (default: false)
+    # @return [Array<Hash>] an array of hashes containing todo details
+    # @example
+    #   client.meeting.todos(1)
+    #   #=> [{ id: 1, title: "Todo Title", due_date: "2024-06-12", ... }, ...]
+    def todos(meeting_id, include_closed: false)
+      response = @conn.get("L10/#{meeting_id}/todos?INCLUDE_CLOSED=#{include_closed}").body
+      response.map do |todo|
+        Types::TodoItem.new(
+          {
+            id: todo["Id"],
+            title: todo["Name"],
+            due_date: todo["DueDate"],
+            notes_url: todo["DetailsUrl"],
+            status: todo["Complete"] ? "Complete" : "Incomplete",
+            created_at: todo["CreateTime"],
+            completed_at: todo["CompleteTime"],
+            user_id: todo.dig("Owner", "Id"),
+            user_name: todo.dig("Owner", "Name")
+          }
+        )
+      end
     end
-  end
 
-  # Lists all metrics for a specific meeting
-  #
-  # @param meeting_id [Integer] the ID of the meeting
-  # @return [Array<Hash>] an array of hashes containing metric details
-  # @example
-  #   client.meeting.metrics(1)
-  #   #=> [{ id: 1, name: "Sales", target: 100, operator: ">", format: "currency", ... }, ...]
-  def metrics(meeting_id)
-    response = @conn.get("L10/#{meeting_id}/measurables").body
-    response.map do |measurable|
-      {
-        id: measurable["Id"],
-        title: measurable["Name"].strip,
-        target: measurable["Target"],
-        operator: measurable["Direction"],
-        format: measurable["Modifiers"],
-        owner: {
-          id: measurable["Owner"]["Id"],
-          name: measurable["Owner"]["Name"]
-        },
-        admin: {
-          id: measurable["Admin"]["Id"],
-          name: measurable["Admin"]["Name"]
-        }
-      }
+    # Lists all metrics for a specific meeting
+    #
+    # @param meeting_id [Integer] the ID of the meeting
+    # @return [Array<Hash>] an array of hashes containing metric details
+    # @example
+    #   client.meeting.metrics(1)
+    #   #=> [{ id: 1, name: "Sales", target: 100, operator: ">", format: "currency", ... }, ...]
+    def metrics(meeting_id)
+      response = @conn.get("L10/#{meeting_id}/measurables").body
+      return [] if response.nil? || !response.is_a?(Array)
+
+      response.map do |measurable|
+        next unless measurable["Id"] && measurable["Name"]
+
+        Types::MetricItem.new(
+          id: measurable["Id"],
+          title: measurable["Name"].to_s.strip,
+          target: measurable["Target"].to_f,
+          operator: measurable["Direction"].to_s,
+          format: measurable["Modifiers"].to_s,
+          user_id: measurable.dig("Owner", "Id"),
+          user_name: measurable.dig("Owner", "Name"),
+          admin_id: measurable.dig("Admin", "Id"),
+          admin_name: measurable.dig("Admin", "Name")
+        )
+      end.compact
     end
-  end
 
-  # Retrieves details of a specific meeting
-  #
-  # @param meeting_id [Integer] the ID of the meeting
-  # @param include_closed [Boolean] whether to include closed issues and todos (default: false)
-  # @return [Hash] a hash containing detailed information about the meeting
-  # @example
-  #   client.meeting.details(1)
-  #   #=> { id: 1, name: "Team Meeting", attendees: [...], issues: [...], todos: [...], metrics: [...] }
-  def details(meeting_id, include_closed: false)
-    meeting = list.find { |m| m[:id] == meeting_id }
-    attendees = attendees(meeting_id)
-    issues = issues(meeting_id, include_closed: include_closed)
-    todos = todos(meeting_id, include_closed: include_closed)
-    measurables = metrics(meeting_id)
-    {
-      id: meeting[:id],
-      title: meeting[:name],
-      attendees: attendees,
-      issues: issues,
-      todos: todos,
-      metrics: measurables
-    }
-  end
+    # Retrieves details of a specific meeting
+    #
+    # @param meeting_id [Integer] the ID of the meeting
+    # @param include_closed [Boolean] whether to include closed issues and todos (default: false)
+    # @return [Hash] a hash containing detailed information about the meeting
+    # @example
+    #   client.meeting.details(1)
+    #   #=> { id: 1, name: "Team Meeting", attendees: [...], issues: [...], todos: [...], metrics: [...] }
+    def details(meeting_id, include_closed: false)
+      meeting = list.find { |m| m.id == meeting_id }
+      Types::MeetingDetails.new(
+        id: meeting.id,
+        title: meeting.title,
+        attendees: attendees(meeting_id),
+        issues: issues(meeting_id, include_closed: include_closed),
+        todos: todos(meeting_id, include_closed: include_closed),
+        metrics: metrics(meeting_id)
+      )
+    end
 
-  # Creates a new meeting
-  #
-  # @param title [String] the title of the new meeting
-  # @param add_self [Boolean] whether to add the current user as an attendee (default: true)
-  # @param attendees [Array<Integer>] a list of user IDs to add as attendees
-  # @return [Hash] a hash containing the new meeting's ID and title, and the list of attendees
-  # @example
-  #   client.meeting.create(title: "New Meeting", attendees: [2, 3])
-  #   #=> { meeting_id: 1, title: "New Meeting", attendees: [2, 3] }
-  def create(title, add_self: true, attendees: [])
-    payload = {title: title, addSelf: add_self}.to_json
-    response = @conn.post("L10/create", payload).body
-    meeting_id = response["meetingId"]
-    meeting_details = {meeting_id: meeting_id, title: title}
-    attendees.each do |attendee|
-      @conn.post("L10/#{meeting_id}/attendees/#{attendee}")
+    # Creates a new meeting
+    #
+    # @param title [String] the title of the new meeting
+    # @param add_self [Boolean] whether to add the current user as an attendee (default: true)
+    # @param attendees [Array<Integer>] a list of user IDs to add as attendees
+    # @return [Hash] a hash containing meeting_id, title and attendees array
+    # @example
+    #   client.meeting.create("New Meeting", attendees: [2, 3])
+    #   #=> { meeting_id: 1, title: "New Meeting", attendees: [2, 3] }
+    def create(title, add_self: true, attendees: [])
+      payload = {title: title, addSelf: add_self}.to_json
+      response = @conn.post("L10/create", payload).body
+      meeting_id = response["meetingId"]
+      meeting_details = {meeting_id: meeting_id, title: title}
+      attendees.each do |attendee|
+        @conn.post("L10/#{meeting_id}/attendees/#{attendee}")
+      end
+      meeting_details.merge(attendees: attendees)
     end
-    meeting_details.merge(attendees: attendees)
-  end
 
-  # Deletes a meeting
-  #
-  # @param meeting_id [Integer] the ID of the meeting to delete
-  # @example
-  #   client.meeting.delete(1)
-  def delete(meeting_id)
-    response = @conn.delete("L10/#{meeting_id}")
-    response.success?
+    # Deletes a meeting
+    #
+    # @param meeting_id [Integer] the ID of the meeting to delete
+    # @return [Boolean] true if deletion was successful
+    # @example
+    #   client.meeting.delete(1)
+    #   #=> true
+    def delete(meeting_id)
+      response = @conn.delete("L10/#{meeting_id}")
+      response.success?
+    end
   end
 end