ghx 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2062a41d9688feddf31afd4a24c6123e0662e80a57fccacd2f391df0800ca982
+  data.tar.gz: aa47601036fad7b097f09f5c14f6d212507b6992ee3899766aa01bf6c2bdfb9a
+SHA512:
+  metadata.gz: 8de5718bf86af69bbddacd5c2be8b86ba396d5d52c0887379bb7f83dd88be28a0defd4b618265429b3e713c29e6f231d6d28b541eb607906045552b01e78bb59
+  data.tar.gz: b82f1220491758e33846e9dd74637f28194b560ca81e197927e38e6ebb881abba36d72e4f5083e0447eca37eafc3efc4b078d8704f650a957ccf2738d20b0a8e

data/lib/ghx/dependabot/alert.rb

@@ -0,0 +1,142 @@
+# Sample Dependabot Alert JSON Shape:
+# {
+#   "number": 321,
+#   "state": "open",
+#   "dependency": {
+#     "package": {
+#       "ecosystem": "npm",
+#       "name": "react-pdf"
+#     },
+#     "manifest_path": "yarn.lock",
+#     "scope": "runtime"
+#   },
+#   "security_advisory": {
+#     "ghsa_id": "GHSA-87hq-q4gp-9wr4",
+#     "cve_id": "CVE-2024-34342",
+#     "summary": "react-pdf vulnerable to arbitrary JavaScript execution upon opening a malicious PDF with PDF.js",
+#     "description": "### Summary\n\nIf PDF.js is used to load a malicious PDF, and PDF.js is configured with `isEvalSupported` set to `true` (which is the default value), unrestricted attacker-controlled JavaScript will be executed in the context of the hosting domain.\n\n### Patches\n[This patch](https://github.com/wojtekmaj/react-pdf/commit/671e6eaa2e373e404040c13cc6b668fe39839cad) forces `isEvalSupported` to `false`, removing the attack vector.\n\n### Workarounds\nSet `options.isEvalSupported` to `false`, where `options` is `Document` component prop.\n\n### References\n- [GHSA-wgrm-67xf-hhpq](https://github.com/mozilla/pdf.js/security/advisories/GHSA-wgrm-67xf-hhpq)\n- https://github.com/mozilla/pdf.js/pull/18015\n- https://github.com/mozilla/pdf.js/commit/85e64b5c16c9aaef738f421733c12911a441cec6\n- https://bugzilla.mozilla.org/show_bug.cgi?id=1893645",
+#     "severity": "high",
+#     "identifiers": [
+#       {
+#         "value": "GHSA-87hq-q4gp-9wr4",
+#         "type": "GHSA"
+#       },
+#       {
+#         "value": "CVE-2024-34342",
+#         "type": "CVE"
+#       }
+#     ],
+#     "references": [
+#       {
+#         "url": "https://github.com/mozilla/pdf.js/security/advisories/GHSA-wgrm-67xf-hhpq"
+#       },
+#       {
+#         "url": "https://github.com/wojtekmaj/react-pdf/security/advisories/GHSA-87hq-q4gp-9wr4"
+#       },
+#       {
+#         "url": "https://nvd.nist.gov/vuln/detail/CVE-2024-34342"
+#       },
+#       {
+#         "url": "https://github.com/mozilla/pdf.js/pull/18015"
+#       },
+#       {
+#         "url": "https://github.com/mozilla/pdf.js/commit/85e64b5c16c9aaef738f421733c12911a441cec6"
+#       },
+#       {
+#         "url": "https://github.com/wojtekmaj/react-pdf/commit/208f28dd47fe38c33ce4bac4205b2b0a0bb207fe"
+#       },
+#       {
+#         "url": "https://github.com/wojtekmaj/react-pdf/commit/671e6eaa2e373e404040c13cc6b668fe39839cad"
+#       },
+#       {
+#         "url": "https://github.com/advisories/GHSA-87hq-q4gp-9wr4"
+#       }
+#     ],
+#     "published_at": "2024-05-07T16:48:59Z",
+#     "updated_at": "2024-05-08T10:10:23Z",
+#     "withdrawn_at": null,
+#     "vulnerabilities": [
+#       {
+#         "package": {
+#           "ecosystem": "npm",
+#           "name": "react-pdf"
+#         },
+#         "severity": "high",
+#         "vulnerable_version_range": "< 7.7.3",
+#         "first_patched_version": {
+#           "identifier": "7.7.3"
+#         }
+#       },
+#       {
+#         "package": {
+#           "ecosystem": "npm",
+#           "name": "react-pdf"
+#         },
+#         "severity": "high",
+#         "vulnerable_version_range": ">= 8.0.0, < 8.0.2",
+#         "first_patched_version": {
+#           "identifier": "8.0.2"
+#         }
+#       }
+#     ],
+#     "cvss": {
+#       "vector_string": "CVSS:3.1/AV:N/AC:H/PR:N/UI:R/S:U/C:H/I:H/A:L",
+#       "score": 7.1
+#     },
+#     "cwes": [
+#       {
+#         "cwe_id": "CWE-79",
+#         "name": "Improper Neutralization of Input During Web Page Generation ('Cross-site Scripting')"
+#       }
+#     ]
+#   },
+#   "security_vulnerability": {
+#     "package": {
+#       "ecosystem": "npm",
+#       "name": "react-pdf"
+#     },
+#     "severity": "high",
+#     "vulnerable_version_range": "< 7.7.3",
+#     "first_patched_version": {
+#       "identifier": "7.7.3"
+#     }
+#   },
+#   "url": "https://api.github.com/repos/CompanyCam/Company-Cam-API/dependabot/alerts/321",
+#   "html_url": "https://github.com/CompanyCam/Company-Cam-API/security/dependabot/321",
+#   "created_at": "2024-05-07T16:54:48Z",
+#   "updated_at": "2024-05-07T16:54:48Z",
+#   "dismissed_at": null,
+#   "dismissed_by": null,
+#   "dismissed_reason": null,
+#   "dismissed_comment": null,
+#   "fixed_at": null,
+#   "auto_dismissed_at": null
+# }
+
+module GHX
+  module Dependabot
+    class Alert
+      attr_reader :number, :state, :dependency, :security_advisory, :security_vulnerability, :url, :html_url, :created_at, :updated_at
+
+      def initialize(json_data)
+        @number = json_data["number"]
+        @state = json_data["state"]
+        @dependency = json_data["dependency"]
+        @security_advisory = json_data["security_advisory"]
+        @security_vulnerability = SecurityVulnerability.new(json_data["security_vulnerability"])
+        @url = json_data["url"]
+        @html_url = json_data["html_url"]
+        @created_at = begin
+          Time.parse(json_data["created_at"])
+        rescue
+          nil
+        end
+        @updated_at = begin
+          Time.parse(json_data["updated_at"])
+        rescue
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/ghx/dependabot/package.rb

@@ -0,0 +1,12 @@
+module GHX
+  module Dependabot
+    class Package
+      attr_reader :ecosystem, :name
+
+      def initialize(json_data)
+        @ecosystem = json_data["ecosystem"]
+        @name = json_data["name"]
+      end
+    end
+  end
+end

data/lib/ghx/dependabot/security_vulnerability.rb

@@ -0,0 +1,14 @@
+module GHX
+  module Dependabot
+    class SecurityVulnerability
+      attr_reader :package, :severity, :vulnerable_version_range, :first_patched_version
+
+      def initialize(json_data)
+        @package = Package.new(json_data["package"])
+        @severity = json_data["severity"]
+        @vulnerable_version_range = json_data["vulnerable_version_range"]
+        @first_patched_version = json_data["first_patched_version"]
+      end
+    end
+  end
+end

data/lib/ghx/dependabot.rb

@@ -0,0 +1,13 @@
+module GHX
+  module Dependabot
+    def self.get_alerts(owner:, repo:)
+      GHX.rest_get("repos/#{owner}/#{repo}/dependabot/alerts?state=open&per_page=100").map do |alert|
+        GHX::Dependabot::Alert.new(alert)
+      end
+    end
+  end
+end
+
+require_relative "dependabot/alert"
+require_relative "dependabot/package"
+require_relative "dependabot/security_vulnerability"

data/lib/ghx/graphql_client.rb

@@ -0,0 +1,68 @@
+module GHX
+  class GraphqlClient
+    def initialize(api_key)
+      @api_key = api_key
+    end
+
+    def query(query)
+      uri = URI("https://api.github.com/graphql")
+      req = Net::HTTP::Post.new(uri)
+      req["Authorization"] = "Bearer #{@api_key}"
+      req["Content-Type"] = "application/json"
+      req.body = {query: query}.to_json
+
+      Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
+        http.request(req)
+      end
+    end
+
+    # @param [String] project_id
+    # @param [GithubProjectItem] project_item
+    # @param [DateTime] reported_at
+    def update_project_item_reported_at(project_item_id:, reported_at:, project_id: GithubProject::MAIN_GH_PROJECT_ID)
+      field_id = "PVTF_lADOALH_aM4Ac-_zzgSzAZs" # project_item.field_map["Reported At"]
+
+      gql_query = <<~GQL
+        mutation {
+          updateProjectV2ItemFieldValue(input: {
+            fieldId: "#{field_id}",
+            itemId: "#{project_item_id}",
+            projectId: "#{project_id}",
+            value: { 
+              date: "#{reported_at.to_date}"
+            }
+          }) {
+            projectV2Item {
+              id  
+            }
+          }
+        }
+      GQL
+
+      query(gql_query)
+    end
+
+    def update_project_item_reported_by(project_item_id:, reported_by:, project_id: GithubProject::MAIN_GH_PROJECT_ID)
+      field_id = "PVTF_lADOALH_aM4Ac-_zzgSzBcc" # project_item.field_map["Reporter"]
+
+      gql_query = <<~GQL
+        mutation {
+          updateProjectV2ItemFieldValue(input: {
+            fieldId: "#{field_id}",
+            itemId: "#{project_item_id}",
+            projectId: "#{project_id}",
+            value: { 
+              text: "#{reported_by}"
+            }
+          }) {
+            projectV2Item {
+              id  
+            }
+          }
+        }
+      GQL
+
+      query(gql_query)
+    end
+  end
+end

data/lib/ghx/issue.rb

@@ -0,0 +1,59 @@
+module GHX
+  class Issue
+    attr_accessor :owner, :repo, :number, :title, :body, :state, :state_reason, :author, :assignees, :labels, :milestone, :created_at, :updated_at, :closed_at
+
+    def self.find(owner:, repo:, number:)
+      response_data = GHX.rest_client.get("repos/#{owner}/#{repo}/issues/#{number}")
+      new(owner: owner, repo: repo, **response_data)
+    end
+
+    def initialize(owner:, repo:, **args)
+      @owner = owner
+      @repo = repo
+      update_attributes(args)
+    end
+
+    def save
+      @number.nil? ? create : update
+    end
+
+    private
+
+    def create
+      response_data = GHX.rest_client.post("repos/#{owner}/#{repo}/issues", {
+        title: @title,
+        body: @body,
+        labels: @labels,
+        milestone: @milestone,
+        assignees: @assignees
+      })
+      update_attributes(response_data)
+      self
+    end
+
+    def update
+      response_data = GHX.rest_client.patch("repos/#{owner}/#{repo}/issues/#{number}", {
+        title: @title,
+        body: @body,
+        labels: @labels,
+        milestone: @milestone,
+        assignees: @assignees,
+        state: @state,
+        state_reason: @state_reason
+      })
+      update_attributes(response_data)
+      self
+    end
+
+    def update_attributes(hash)
+      self.number = hash["number"]
+      self.title = hash["title"]
+      self.body = hash["body"]
+      self.state = hash["state"]
+      self.state_reason = hash["state_reason"]
+      self.labels = hash["labels"]
+      self.milestone = hash["milestone"]
+      self.assignees = hash["assignees"]
+    end
+  end
+end

data/lib/ghx/project.rb

@@ -0,0 +1,282 @@
+module GHX
+  class Project
+    attr_reader :id
+
+    def initialize(id)
+      @id = id
+      @field_configuration = nil
+    end
+
+    def field_configuration
+      @field_configuration ||= _fetch_field_configuration
+    end
+
+    def _fetch_field_configuration
+      gql_query = <<~GQL
+        query {
+          node(id: "#{id}") {
+            ... on ProjectV2 {  
+              fields(first: 100) {  
+                nodes { 
+                  ... on ProjectV2Field {
+                    id  
+                    name
+                    dataType
+                  } 
+
+                  ... on ProjectV2SingleSelectField {
+                    id
+                    name
+                    dataType
+                    options {  
+                        id  
+                        name  
+                    }
+                  }
+
+                  ... on ProjectV2IterationField {
+                    id  
+                    name  
+                    dataType
+                  }
+
+
+                }
+              } 
+            } 
+          }
+        } 
+      GQL
+
+      client = GraphqlClient.new(ENV["GITHUB_TOKEN"])
+      res = client.query(gql_query)
+
+      data = JSON.parse(res.body)
+
+      data.dig("data", "node", "fields", "nodes").collect do |field|
+        {
+          id: field["id"],
+          name: field["name"],
+          data_type: field["dataType"],
+          options: field["options"]&.map { |option| {id: option["id"], name: option["name"]} }
+        }
+      end
+    end
+
+    def find_item_by_id(item_id)
+      #       gql_query = <<~GQL
+      #       query {
+      #         node(id: "#{id}") {
+      #           ... on Issue {
+      #             number
+      #             title
+      #             url
+      #           }
+      #         }
+      #       }
+      # GQL
+      #
+      #       client = GraphqlClient.new(ENV["GITHUB_TOKEN"])
+      #       res = client.query(gql_query)
+      #
+      #       puts res.body
+    end
+
+    # In order to find an item by its issue number, we need to query the project items and filter by the issue number,
+    # then return the first item that matches the project ID.
+    def find_item_by_issue_number(number:, owner: "CompanyCam", repo: "Company-Cam-API")
+      gql_query = <<~GQL
+              query {
+          repository(owner: "#{owner}", name: "#{repo}") {
+            issue(number: #{number.to_i}) {
+              id
+              number
+              title
+              url
+              body
+              createdAt
+              projectItems(first: 100) {
+                nodes {
+                  id
+                  project {
+                    id
+                    databaseId
+                  }
+        content {
+                          ... on Issue {
+                            number
+                            title
+                            url
+                            state
+                            assignees(first: 10) {
+                              nodes {
+                                login
+                              }
+                            }
+                          }
+                        }
+                        fieldValues(first: 30) {
+                          nodes {
+                            ... on ProjectV2ItemFieldSingleSelectValue {
+                              field {
+                                ... on ProjectV2SingleSelectField {
+                                  name
+                                }
+                              }
+                              name
+                              id
+                            }
+                            ... on ProjectV2ItemFieldLabelValue {
+                              labels(first: 20) {
+                                nodes {
+                                  id
+                                  name
+                                }
+                              }
+                            }
+                            ... on ProjectV2ItemFieldTextValue {
+                              text
+                              id
+                              updatedAt
+                              creator {
+                                url
+                              }
+                              field {
+                                 ... on ProjectV2Field {
+                                    id
+                                    name
+                                 }
+                              }
+                            }
+                            ... on ProjectV2ItemFieldMilestoneValue {
+                              milestone {
+                                id
+                              }
+                            }
+                            ... on ProjectV2ItemFieldRepositoryValue {
+                              repository {
+                                id
+                                url
+                              }
+                            }
+                            ... on ProjectV2ItemFieldDateValue {
+                              date
+                              field {
+                                ... on ProjectV2FieldCommon {
+                                  id
+                                  name
+                                }
+                              }    
+                            }
+                          }
+                        }
+                }
+              }
+            }
+          }
+        }
+      GQL
+
+      client = GraphqlClient.new(ENV["GITHUB_TOKEN"])
+      res = client.query(gql_query)
+
+      data = JSON.parse(res.body)
+
+      project_item_data = data.dig("data", "repository", "issue", "projectItems", "nodes").find { |node| node["project"]["id"] == id }
+
+      ProjectItem.new(field_configuration: field_configuration, data: project_item_data)
+    end
+
+    def get_all_items
+      gql_query = <<~GQL
+        query {
+          node(id: "#{id}") {
+            ... on ProjectV2 {
+              items(last: 100) {
+                nodes {
+                  id
+                  content {
+                    ... on Issue {
+                      number
+                      title
+                      url
+                      state
+                      assignees(first: 10) {
+                        nodes {
+                          login
+                        }
+                      }
+                    }
+                  }
+                  fieldValues(first: 20) {
+                    nodes {
+                      ... on ProjectV2ItemFieldSingleSelectValue {
+                        field {
+                          ... on ProjectV2SingleSelectField {
+                            name
+                          }
+                        }
+                        name
+                        id
+                      }
+                      ... on ProjectV2ItemFieldLabelValue {
+                        labels(first: 20) {
+                          nodes {
+                            id
+                            name
+                          }
+                        }
+                      }
+                      ... on ProjectV2ItemFieldTextValue {
+                        text
+                        id
+                        updatedAt
+                        creator {
+                          url
+                        }
+                        field {
+                           ... on ProjectV2Field {
+                              id
+                              name
+                           }
+                        }
+                      }
+                      ... on ProjectV2ItemFieldMilestoneValue {
+                        milestone {
+                          id
+                        }
+                      }
+                      ... on ProjectV2ItemFieldRepositoryValue {
+                        repository {
+                          id
+                          url
+                        }
+                      }
+                      ... on ProjectV2ItemFieldDateValue {
+                        date
+                        field {
+                          ... on ProjectV2FieldCommon {
+                            id
+                            name
+                          }
+                        }    
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      GQL
+
+      res = GraphqlClient.default.query(gql_query)
+
+      data = JSON.parse res.body
+
+      items = data["data"]["node"]["items"]["nodes"]
+
+      items.map { ProjectItem.new(field_configuration: field_configuration, data: _1) }
+    end
+  end
+end

data/lib/ghx/project_item.rb

@@ -0,0 +1,209 @@
+module GHX
+  class ProjectItem
+    attr_accessor :id, :project_id, :issue_number, :issue_title, :issue_url, :issue_state, :field_values, :field_map
+
+    def initialize(field_configuration:, data:)
+      _setup_field_configuration(field_configuration)
+
+      GHX.logger.debug data
+
+      node = data
+      content = node["content"]
+
+      # These are fields common to all Project Items:
+      @id = node["id"]
+      @project_id = node["project"]["id"]
+      @issue_number = content["number"]
+      @issue_title = content["title"]
+      @issue_url = content["url"]
+      @issue_state = content["state"]
+
+      field_values = node["fieldValues"]["nodes"]
+
+      field_values.each do |field|
+        GHX.logger.debug "Field: #{field}"
+        next unless field["field"]
+        next if field["field"]["name"].to_s.empty?
+
+        name = normalized_field_value_name(field["field"]["name"])
+
+        public_send(:"#{name}=", extracted_field_value(field))
+      rescue NoMethodError
+        GHX.logger.warn "Could not find field name: #{field["field"]["name"]} in the field configuration for project item #{id}"
+      end
+    end
+
+    # Updates the given fields to the given values. Makes a GraphQL call per field to do the update.
+    #
+    # @param fields [Hash] A hash of field names to values.
+    def update(**fields)
+      fields.each do |field, value|
+        field_id = field_id(field)
+        raise "Field not found: #{field}" unless field_id
+
+        field_type = field_type(field)
+
+        case field_type
+        when "DATE"
+          update_date_field(field_id, value)
+        when "SINGLE_SELECT"
+          update_single_select_field(field_id, value)
+        when "TEXT"
+          update_text_field(field_id, value)
+        when "TITLE"
+          update_title_field(field_id, value)
+        else
+          GHX.logger.warn "Unknown field type in update: #{field_type}"
+        end
+      end
+    end
+
+    def update_text_field(field_id, value)
+      gql_query = <<~GQL
+        mutation {
+          updateProjectV2ItemFieldValue(input: {
+            fieldId: "#{field_id}",
+            itemId: "#{id}",
+            projectId: "#{project_id}",
+            value: { 
+              text: "#{value}"
+            }
+          }) {
+            projectV2Item {
+              id  
+            }
+          }
+        }
+      GQL
+
+      client = GraphqlClient.new(ENV["GITHUB_TOKEN"])
+      res = client.query(gql_query)
+      GHX.logger.debug "Update text field result"
+      GHX.logger.debug res
+    end
+
+    def update_date_field(field_id, value)
+      gql_query = <<~GQL
+        mutation {
+          updateProjectV2ItemFieldValue(input: {
+            fieldId: "#{field_id}",
+            itemId: "#{id}",
+            projectId: "#{project_id}",
+            value: { 
+              date: "#{value}"
+            }
+          }) {
+            projectV2Item {
+              id  
+            }
+          }
+        }
+      GQL
+
+      client = GraphqlClient.new(ENV["GITHUB_TOKEN"])
+      res = client.query(gql_query)
+      GHX.logger.debug "Update date field result"
+      GHX.logger.debug res
+    end
+
+    def update_single_select_field(field_id, value)
+      field_options = field_options(field_id)
+      raise "No options found for #{field_id}" unless field_options
+
+      option_id = field_options.find { |option| option[:name] == value }&.fetch(:id)
+      raise "Option not found: #{value}" unless option_id
+
+      gql_query = <<~GQL
+        mutation {
+          updateProjectV2ItemFieldValue(input: {
+            fieldId: "#{field_id}",
+            itemId: "#{id}",
+            projectId: "#{project_id}",
+            value: { 
+              singleSelectOptionId: "#{option_id}"
+            }
+          }) {
+            projectV2Item {
+              id  
+            }
+          }
+        }
+      GQL
+
+      client = GraphqlClient.new(ENV["GITHUB_TOKEN"])
+      res = client.query(gql_query)
+      GHX.logger.debug "Update single select field result"
+      GHX.logger.debug res.body
+    end
+
+    private
+
+    def _setup_field_configuration(field_configuration)
+      @field_configuration = field_configuration.map { |fc| fc.merge({normalized_name: normalized_field_value_name(fc[:name])}) }
+
+      # Example field_configuration:
+      # {:id=>"PVTF_lADOALH_aM4Ac-_zzgSxCno", :name=>"Title", :data_type=>"TITLE", :options=>nil}
+      # {:id=>"PVTF_lADOALH_aM4Ac-_zzgSxCns", :name=>"Assignees", :data_type=>"ASSIGNEES", :options=>nil}
+      # {:id=>"PVTF_lADOALH_aM4Ac-_zzgSzAZs", :name=>"Reported At", :data_type=>"DATE", :options=>nil}
+      # {:id=>"PVTSSF_lADOALH_aM4Ac-_zzgSxCnw", :name=>"Status", :data_type=>"SINGLE_SELECT", :options=>[{:id=>"f971fb55", :name=>"To triage"}, {:id=>"856cdede", :name=>"Ready to Assign"}, {:id=>"f75ad846", :name=>"Assigned"}, {:id=>"47fc9ee4", :name=>"Fix In progress"}, {:id=>"5ef0dc97", :name=>"Additional Info Requested"}, {:id=>"98236657", :name=>"Done - Fixed"}, {:id=>"98aea6ad", :name=>"Done - Won't Fix"}, {:id=>"a3b4fc3a", :name=>"Duplicate"}, {:id=>"81377549", :name=>"Not a Vulnerability"}]}
+      # {:id=>"PVTF_lADOALH_aM4Ac-_zzgSxCn0", :name=>"Labels", :data_type=>"LABELS", :options=>nil}
+      # {:id=>"PVTF_lADOALH_aM4Ac-_zzgSxCn4", :name=>"Linked pull requests", :data_type=>"LINKED_PULL_REQUESTS", :options=>nil}
+      # {:id=>"PVTF_lADOALH_aM4Ac-_zzgSxCn8", :name=>"Milestone", :data_type=>"MILESTONE", :options=>nil}
+      # {:id=>"PVTF_lADOALH_aM4Ac-_zzgSxCoA", :name=>"Repository", :data_type=>"REPOSITORY", :options=>nil}
+      # {:id=>"PVTF_lADOALH_aM4Ac-_zzgSxCoM", :name=>"Reviewers", :data_type=>"REVIEWERS", :options=>nil}
+      # {:id=>"PVTSSF_lADOALH_aM4Ac-_zzgSxCuA", :name=>"Severity", :data_type=>"SINGLE_SELECT", :options=>[{:id=>"79628723", :name=>"Informational"}, {:id=>"153889c6", :name=>"Low"}, {:id=>"093709ee", :name=>"Medium"}, {:id=>"5a00bbe7", :name=>"High"}, {:id=>"00e0bbaf", :name=>"Critical"}, {:id=>"fd986bd9", :name=>"Duplicate"}]}
+      # {:id=>"PVTF_lADOALH_aM4Ac-_zzgSzBcc", :name=>"Reporter", :data_type=>"TEXT", :options=>nil}
+      # {:id=>"PVTF_lADOALH_aM4Ac-_zzgSzBho", :name=>"Resolve By", :data_type=>"DATE", :options=>nil}
+      # {:id=>"PVTSSF_lADOALH_aM4Ac-_zzgTKjOw", :name=>"Payout Status", :data_type=>"SINGLE_SELECT", :options=>[{:id=>"53c47c02", :name=>"Ready for Invoice"}, {:id=>"0b8a4629", :name=>"Payout in Process"}, {:id=>"5f356a58", :name=>"Payout Complete"}, {:id=>"368048ac", :name=>"Ineligible for Payout"}]}
+      @field_configuration.each do |field|
+        next unless field[:name]
+        next if field[:name].to_s.empty?
+
+        # Example
+        # name = "Reported At"
+        # instance variable will be `@reported_at`
+        # attr_accessor will be `reported_at`
+        name = normalized_field_value_name(field[:name])
+        instance_variable_set(:"@#{name}", nil)
+        self.class.attr_accessor name.to_sym
+      end
+    end
+
+    def normalized_field_value_name(name)
+      name.tr(" ", "_").downcase
+    end
+
+    # Extracts the value from the field based on the field's data type. Thank you GraphQL for making this totally asinine.
+    def extracted_field_value(field)
+      this_field_configuration = @field_configuration.find { |f| f[:name] == field["field"]["name"] }
+
+      case this_field_configuration[:data_type]
+      when "DATE"
+        field["date"]
+      when "SINGLE_SELECT"
+        field["name"]
+      when "TEXT"
+        field["text"]
+      when "TITLE"
+        field["text"]
+      else
+        GHX.logger.warn "Unknown data type in extracted_field_value: #{this_field_configuration[:data_type]}"
+      end
+    end
+
+    def field_id(normalized_field_name)
+      field = @field_configuration.find { |f| f[:normalized_name] == normalized_field_name.to_s }
+      field[:id] if field
+    end
+
+    def field_type(normalized_field_name)
+      field = @field_configuration.find { |f| f[:normalized_name] == normalized_field_name.to_s }
+      field[:data_type] if field
+    end
+
+    def field_options(field_id)
+      field = @field_configuration.find { |f| f[:id] == field_id }
+      field[:options] if field
+    end
+  end
+end

data/lib/ghx/rest_client.rb

@@ -0,0 +1,72 @@
+require "net/http"
+
+module GHX
+  class RestClient
+    attr_reader :api_key
+
+    def initialize(api_key)
+      @api_key = api_key
+    end
+
+    # @return [Hash] the JSON response
+    def get(path)
+      uri = URI.parse("https://api.github.com/#{path}")
+      request = Net::HTTP::Get.new(uri)
+      request["Accept"] = "application/vnd.github+json"
+      request["Authorization"] = "Bearer #{@api_key}"
+      request["X-Github-Api-Version"] = "2022-11-28"
+
+      req_options = {
+        use_ssl: uri.scheme == "https"
+      }
+
+      response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
+        http.request(request)
+      end
+
+      JSON.parse(response.body)
+    end
+
+    # @return [Hash] the JSON response
+    def post(path, params)
+      uri = URI.parse("https://api.github.com/#{path}")
+      request = Net::HTTP::Post.new(uri)
+      request["Accept"] = "application/vnd.github+json"
+      request["Authorization"] = "Bearer #{@api_key}"
+      request["X-Github-Api-Version"] = "2022-11-28"
+
+      req_options = {
+        use_ssl: uri.scheme == "https"
+      }
+
+      request.body = params.to_json
+
+      response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
+        http.request(request)
+      end
+
+      JSON.parse(response.body)
+    end
+
+    # @return [Hash] the JSON response
+    def patch(path, params)
+      uri = URI.parse("https://api.github.com/#{path}")
+      request = Net::HTTP::Patch.new(uri)
+      request["Accept"] = "application/vnd.github+json"
+      request["Authorization"] = "Bearer #{@api_key}"
+      request["X-Github-Api-Version"] = "2022-11-28"
+
+      req_options = {
+        use_ssl: uri.scheme == "https"
+      }
+
+      request.body = params.to_json
+
+      response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
+        http.request(request)
+      end
+
+      JSON.parse(response.body)
+    end
+  end
+end

data/lib/ghx.rb

@@ -0,0 +1,50 @@
+require "time"
+require "net/http"
+require "json"
+require "octokit"
+
+require_relative "version"
+require_relative "ghx/graphql_client"
+require_relative "ghx/rest_client"
+require_relative "ghx/dependabot"
+require_relative "ghx/issue"
+require_relative "ghx/project"
+require_relative "ghx/project_item"
+
+# GitHub eXtended API Interface
+#
+# Extra classes to support more OO interfaces to the GitHub API. Wraps both the REST API and GraphQL API. Currently
+# incomplete. Functionality has been built for our existing use-cases, but nothing else.
+module GHX
+  def self.logger
+    @logger ||= Logger.new($stdout)
+  end
+
+  def self.logger=(logger)
+    @logger = logger
+  end
+
+  def self.octokit
+    @octokit ||= Octokit::Client.new(access_token: ENV["GITHUB_TOKEN"])
+  end
+
+  def self.octokit=(octokit)
+    @octokit = octokit
+  end
+
+  def self.graphql
+    @graphql ||= GHX::GraphqlClient.new(ENV["GITHUB_GRAPHQL_TOKEN"])
+  end
+
+  def self.graphql=(graphql)
+    @graphql = graphql
+  end
+
+  def self.rest_client
+    @rest_client ||= GHX::RestClient.new(ENV["GITHUB_TOKEN"])
+  end
+
+  def self.rest_client=(rest_client)
+    @rest_client = rest_client
+  end
+end

data/lib/version.rb

@@ -0,0 +1,3 @@
+module GHX
+  VERSION = "0.0.3"
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: ghx
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- CompanyCam
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-05-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.0
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.1
+- !ruby/object:Gem::Dependency
+  name: standardrb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: An object oriented wrapper around some GitHub API calls that aren't covered
+  by Octokit
+email: jeff.mcfadden@companycam.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ghx.rb
+- lib/ghx/dependabot.rb
+- lib/ghx/dependabot/alert.rb
+- lib/ghx/dependabot/package.rb
+- lib/ghx/dependabot/security_vulnerability.rb
+- lib/ghx/graphql_client.rb
+- lib/ghx/issue.rb
+- lib/ghx/project.rb
+- lib/ghx/project_item.rb
+- lib/ghx/rest_client.rb
+- lib/version.rb
+homepage: https://github.com/companycam/ghx
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.10
+signing_key:
+specification_version: 4
+summary: Wrapper around some GitHub API calls
+test_files: []