hi_energy_ai 0.1.0

data/lib/hi_energy_ai/paginator.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  class Paginator
+    include Enumerable
+
+    def initialize(client:, path:, params: {}, first_response: nil)
+      @client = client
+      @path = path
+      @params = params
+      @first_response = first_response
+    end
+
+    def each
+      response = @first_response || @client.get(@path, params: @params)
+
+      loop do
+        yield response
+
+        break unless response.has_more?
+
+        next_params = @params.merge(response.next_page_params)
+        response = @client.get(@path, params: next_params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resource.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  class Resource
+    def initialize(client)
+      @client = client
+    end
+
+    private
+
+    attr_reader :client
+
+    def get(path, params: {})
+      client.get(path, params: params)
+    end
+
+    def post(path, params: {}, body: nil)
+      client.post(path, params: params, body: body)
+    end
+
+    def patch(path, params: {}, body: nil)
+      client.patch(path, params: params, body: body)
+    end
+
+    def delete(path, params: {})
+      client.delete(path, params: params)
+    end
+
+    def app_get(path, params: {})
+      client.app_get(path, params: params)
+    end
+
+    def app_post(path, params: {}, body: nil)
+      client.app_post(path, params: params, body: body)
+    end
+  end
+end

data/lib/hi_energy_ai/resources/advertisers.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Advertisers < Resource
+      def list(**params)
+        get("/advertisers", params: params)
+      end
+
+      def find(id, **params)
+        get("/advertisers/#{id}", params: params)
+      end
+
+      def search_by_domain(domain:, **params)
+        get("/advertisers/search_by_domain", params: params.merge(domain: domain))
+      end
+
+      def by_domain(domain:, **params)
+        list(domain: domain, **params)
+      end
+
+      def contacts(id, **params)
+        get("/advertisers/#{id}/contacts", params: params)
+      end
+
+      def similar(id, **params)
+        get("/advertisers/#{id}/similar_advertisers", params: params)
+      end
+
+      def related(id, **params)
+        get("/advertisers/#{id}/related_advertisers", params: params)
+      end
+
+      def find_more_contacts(id, **params)
+        post("/advertisers/#{id}/find_more_contacts", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/agencies.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Agencies < Resource
+      def list(**params)
+        get("/agencies", params: params)
+      end
+
+      def find(id, **params)
+        get("/agencies/#{id}", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/clicks.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Clicks < Resource
+      def list(start_date:, end_date:, **params)
+        get("/clicks", params: params.merge(start_date: start_date, end_date: end_date))
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/contacts.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Contacts < Resource
+      def list(**params)
+        get("/contacts", params: params)
+      end
+
+      def create(attributes, **params)
+        post("/contacts", params: params, body: { contact: attributes })
+      end
+
+      def add(attributes, **params)
+        post("/contacts/add", params: params, body: { contact: attributes })
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/deals.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Deals < Resource
+      def list(**params)
+        get("/deals", params: params)
+      end
+
+      def find(id, **params)
+        get("/deals/#{id}", params: params)
+      end
+
+      def types(**params)
+        get("/deals/types", params: params)
+      end
+
+      def translate(id, **params)
+        post("/deals/#{id}/translate", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/deeplinks.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Deeplinks < Resource
+      def generate(attributes, **params)
+        post("/deeplinks/generate", params: params, body: attributes)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/domains.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Domains < Resource
+      def search(domain:, **params)
+        get("/domains/search", params: params.merge(domain: domain))
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/exports.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Exports < Resource
+      def list(**params)
+        get("/exports", params: params)
+      end
+
+      def find(id, **params)
+        get("/exports/#{id}", params: params)
+      end
+
+      def create(attributes, **params)
+        post("/exports", params: params, body: attributes)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/mcp.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Mcp < Resource
+      def bootstrap(**params)
+        app_get("mcp", params: params)
+      end
+
+      def integration(**params)
+        app_get("mcp/integration.json", params: params)
+      end
+
+      def initialize_session(protocol_version: "2025-11-25", id: 1, **params)
+        app_post(
+          "mcp",
+          params: params,
+          body: {
+            jsonrpc: "2.0",
+            id: id,
+            method: "initialize",
+            params: { protocolVersion: protocol_version }
+          }
+        )
+      end
+
+      def call(method, params: {}, id: 1, **query)
+        app_post(
+          "mcp",
+          params: query,
+          body: {
+            jsonrpc: "2.0",
+            id: id,
+            method: method,
+            params: params
+          }
+        )
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/networks.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Networks < Resource
+      def list(**params)
+        get("/networks", params: params)
+      end
+
+      def find(id, **params)
+        get("/networks/#{id}", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/opportunities.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Opportunities < Resource
+      def list(**params)
+        get("/opportunities", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/publishers.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Publishers < Resource
+      def list(**params)
+        get("/publishers", params: params)
+      end
+
+      def find(id, **params)
+        get("/publishers/#{id}", params: params)
+      end
+
+      def create(attributes, **params)
+        post("/publishers", params: params, body: { publisher: attributes })
+      end
+
+      def update(id, attributes, **params)
+        patch("/publishers/#{id}", params: params, body: { publisher: attributes })
+      end
+
+      def find_linkedin_users(id, **params)
+        post("/publishers/#{id}/find_linkedin_users", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/reports.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Reports < Resource
+      def list(**params)
+        get("/reports", params: params)
+      end
+
+      def find(id, **params)
+        get("/reports/#{id}", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/schema.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Schema < Resource
+      def fetch(**params)
+        get("/schema", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/search.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Search < Resource
+      def query(q:, **params)
+        get("/search", params: params.merge(q: q))
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/status_changes.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class StatusChanges < Resource
+      def list(**params)
+        get("/status_changes", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/tags.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Tags < Resource
+      def list(**params)
+        get("/tags", params: params)
+      end
+
+      alias search list
+
+      def advertisers(id, **params)
+        get("/tags/#{id}/advertisers", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/tools.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Tools < Resource
+      def list(**params)
+        get("/tools", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/transactions.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Transactions < Resource
+      def list(**params)
+        get("/transactions", params: params)
+      end
+
+      def find(id, **params)
+        get("/transactions/#{id}", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/users.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Users < Resource
+      def list(**params)
+        get("/users", params: params)
+      end
+
+      def find(id, **params)
+        get("/users/#{id}", params: params)
+      end
+
+      def create(attributes, **params)
+        post("/users", params: params, body: { user: attributes })
+      end
+
+      def update(id, attributes, **params)
+        patch("/users/#{id}", params: params, body: { user: attributes })
+      end
+
+      def resend_invitation(id, **params)
+        post("/users/#{id}/resend_invitation", params: params)
+      end
+
+      def rotate_api_key(id, **params)
+        post("/users/#{id}/rotate_api_key", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/resources/verticals.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  module Resources
+    class Verticals < Resource
+      def list(**params)
+        get("/verticals", params: params)
+      end
+    end
+  end
+end

data/lib/hi_energy_ai/response.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  class Response
+    attr_reader :status, :headers, :body, :data, :meta, :raw
+
+    def initialize(status:, headers:, body:)
+      @status = status
+      @headers = headers
+      @body = body
+      @raw = body
+      @data = body.is_a?(Hash) ? (body["data"] || body[:data]) : body
+      @meta = body.is_a?(Hash) ? (body["meta"] || body[:meta]) : nil
+    end
+
+    def success?
+      status >= 200 && status < 300
+    end
+
+    def [](key)
+      return body[key] if body.is_a?(Hash)
+
+      nil
+    end
+
+    def to_h
+      body.is_a?(Hash) ? body : { "data" => body }
+    end
+
+    def pagination
+      return meta if meta.is_a?(Hash) && meta.key?("pagination")
+
+      body.is_a?(Hash) ? (body["pagination"] || body[:pagination]) : nil
+    end
+
+    def next_page
+      return nil unless meta.is_a?(Hash)
+
+      meta["next_page"] || meta[:next_page]
+    end
+
+    def has_more?
+      return meta["has_more"] if meta.is_a?(Hash) && meta.key?("has_more")
+      return meta[:has_more] if meta.is_a?(Hash) && meta.key?(:has_more)
+
+      !next_page.nil?
+    end
+
+    def next_page_params
+      page = next_page
+      return nil if page.nil?
+
+      { page: page }
+    end
+  end
+end

data/lib/hi_energy_ai/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module HiEnergyAi
+  VERSION = "0.1.0"
+end

data/lib/hi_energy_ai.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "json"
+
+require_relative "hi_energy_ai/version"
+require_relative "hi_energy_ai/error"
+require_relative "hi_energy_ai/configuration"
+require_relative "hi_energy_ai/response"
+require_relative "hi_energy_ai/paginator"
+require_relative "hi_energy_ai/resource"
+require_relative "hi_energy_ai/client"
+
+Dir[File.join(__dir__, "hi_energy_ai/resources", "*.rb")].sort.each { |file| require file }
+
+module HiEnergyAi
+  class << self
+    def new(**options)
+      Client.new(**options)
+    end
+
+    def configure(&block)
+      Client.configure(&block)
+    end
+
+    def documentation_url
+      Configuration::DOCUMENTATION_URL
+    end
+  end
+end