misarseo 1.0.0

data/lib/misarseo/generated/rank_tracking.rb

@@ -0,0 +1,144 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.rank_tracking+ — 23 endpoint(s).
+    class RankTrackingResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # POST /rank-tracking/annotations
+      def add_annotation(body = nil, query: nil, **fields)
+        @transport.request("POST", "/rank-tracking/annotations", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /rank-tracking/competitors
+      def add_competitor(body = nil, query: nil, **fields)
+        @transport.request("POST", "/rank-tracking/competitors", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /rank-tracking/keywords
+      def add_keywords(body = nil, query: nil, **fields)
+        @transport.request("POST", "/rank-tracking/keywords", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /rank-tracking/configs
+      def create(body = nil, query: nil, **fields)
+        @transport.request("POST", "/rank-tracking/configs", query: query, body: Transport.body(body, fields))
+      end
+
+      # DELETE /rank-tracking/configs
+      def delete(body = nil, query: nil, **fields)
+        @transport.request("DELETE", "/rank-tracking/configs", query: query, body: Transport.body(body, fields))
+      end
+
+      # GET /rank-tracking/keywords
+      #
+      # Optional query parameters: +page+, +pageSize+.
+      def get(config_id, project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/keywords", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id), body: nil)
+      end
+
+      # GET /rank-tracking/ai-overview-trend
+      #
+      # Optional query parameters: +device+, +sinceDays+.
+      def get_ai_overview_trend(config_id, project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/ai-overview-trend", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id), body: nil)
+      end
+
+      # GET /rank-tracking/trend
+      #
+      # Optional query parameters: +device+, +sinceDays+.
+      def get_config_trend(config_id, project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/trend", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id), body: nil)
+      end
+
+      # GET /rank-tracking/keyword-history
+      #
+      # Optional query parameters: +sinceDays+.
+      def get_keyword_history(config_id, project_id, tracking_keyword_id, query: nil)
+        @transport.request("GET", "/rank-tracking/keyword-history", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id, "trackingKeywordId" => tracking_keyword_id), body: nil)
+      end
+
+      # GET /rank-tracking/runs
+      def get_latest_run(config_id, project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/runs", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id), body: nil)
+      end
+
+      # GET /rank-tracking/movers
+      #
+      # Optional query parameters: +minGain+, +sinceDays+.
+      def get_rank_movers(config_id, project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/movers", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id), body: nil)
+      end
+
+      # GET /rank-tracking/volatility
+      #
+      # Optional query parameters: +device+, +runLimit+.
+      def get_volatility_index(config_id, project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/volatility", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id), body: nil)
+      end
+
+      # GET /rank-tracking/annotations
+      def list_annotations(config_id, project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/annotations", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id), body: nil)
+      end
+
+      # GET /rank-tracking/cannibalisation
+      def list_cannibalisation(config_id, project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/cannibalisation", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id), body: nil)
+      end
+
+      # GET /rank-tracking/competitors
+      #
+      # Optional query parameters: +device+.
+      def list_competitors(config_id, project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/competitors", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id), body: nil)
+      end
+
+      # GET /rank-tracking/configs
+      def list_configs(project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/configs", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # GET /rank-tracking/keyword-tags
+      def list_keyword_tags(config_id, project_id, query: nil)
+        @transport.request("GET", "/rank-tracking/keyword-tags", query: Transport.merge(query, "configId" => config_id, "projectId" => project_id), body: nil)
+      end
+
+      # DELETE /rank-tracking/annotations
+      def remove_annotation(body = nil, query: nil, **fields)
+        @transport.request("DELETE", "/rank-tracking/annotations", query: query, body: Transport.body(body, fields))
+      end
+
+      # DELETE /rank-tracking/competitors
+      def remove_competitor(body = nil, query: nil, **fields)
+        @transport.request("DELETE", "/rank-tracking/competitors", query: query, body: Transport.body(body, fields))
+      end
+
+      # DELETE /rank-tracking/keywords
+      def remove_keywords(body = nil, query: nil, **fields)
+        @transport.request("DELETE", "/rank-tracking/keywords", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /rank-tracking/keyword-target-url
+      def set_keyword_target_url(body = nil, query: nil, **fields)
+        @transport.request("POST", "/rank-tracking/keyword-target-url", query: query, body: Transport.body(body, fields))
+      end
+
+      # PATCH /rank-tracking/configs
+      def update(body = nil, query: nil, **fields)
+        @transport.request("PATCH", "/rank-tracking/configs", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /rank-tracking/keyword-tags
+      def update_keyword_tag(body = nil, query: nil, **fields)
+        @transport.request("POST", "/rank-tracking/keyword-tags", query: query, body: Transport.body(body, fields))
+      end
+    end
+  end
+end

data/lib/misarseo/generated/report_builder.rb

@@ -0,0 +1,67 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.report_builder+ — 10 endpoint(s).
+    class ReportBuilderResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # POST /reports/definitions
+      def create_definition(body = nil, query: nil, **fields)
+        @transport.request("POST", "/reports/definitions", query: query, body: Transport.body(body, fields))
+      end
+
+      # DELETE /reports/definitions/:reportDefinitionId
+      def delete_definition(report_definition_id, project_id, query: nil)
+        @transport.request("DELETE", "/reports/definitions/#{Transport.seg(report_definition_id)}", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # DELETE /reports/definitions/:reportDefinitionId/schedule
+      def delete_schedule(report_definition_id, project_id, query: nil)
+        @transport.request("DELETE", "/reports/definitions/#{Transport.seg(report_definition_id)}/schedule", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # GET /reports/definitions/:reportDefinitionId
+      def get_definition(report_definition_id, project_id, query: nil)
+        @transport.request("GET", "/reports/definitions/#{Transport.seg(report_definition_id)}", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # GET /reports/definitions/:reportDefinitionId/schedule
+      def get_schedule(report_definition_id, project_id, query: nil)
+        @transport.request("GET", "/reports/definitions/#{Transport.seg(report_definition_id)}/schedule", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # GET /reports/definitions
+      def list_definitions(project_id, query: nil)
+        @transport.request("GET", "/reports/definitions", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # PATCH /reports/definitions/:reportDefinitionId
+      def rename_definition(report_definition_id, body = nil, query: nil, **fields)
+        @transport.request("PATCH", "/reports/definitions/#{Transport.seg(report_definition_id)}", query: query, body: Transport.body(body, fields))
+      end
+
+      # GET /reports/definitions/:reportDefinitionId/render
+      #
+      # Optional query parameters: +periodDays+.
+      def render_definition(report_definition_id, project_id, query: nil)
+        @transport.request("GET", "/reports/definitions/#{Transport.seg(report_definition_id)}/render", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # POST /reports/definitions/:reportDefinitionId/widgets
+      def set_widgets(report_definition_id, body = nil, query: nil, **fields)
+        @transport.request("POST", "/reports/definitions/#{Transport.seg(report_definition_id)}/widgets", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /reports/definitions/:reportDefinitionId/schedule
+      def upsert_schedule(report_definition_id, body = nil, query: nil, **fields)
+        @transport.request("POST", "/reports/definitions/#{Transport.seg(report_definition_id)}/schedule", query: query, body: Transport.body(body, fields))
+      end
+    end
+  end
+end

data/lib/misarseo/generated/resources.rb

@@ -0,0 +1,85 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+require_relative "account"
+require_relative "activity"
+require_relative "ahrefs"
+require_relative "ai_search"
+require_relative "backlinks"
+require_relative "baidu"
+require_relative "bing"
+require_relative "brave_search"
+require_relative "competitor_monitor"
+require_relative "competitors"
+require_relative "content"
+require_relative "crawl"
+require_relative "dashboard"
+require_relative "direct_vendor_ai"
+require_relative "disavow"
+require_relative "domain"
+require_relative "ga4"
+require_relative "google_business_profile"
+require_relative "gsc"
+require_relative "index_now"
+require_relative "keywords"
+require_relative "link_building"
+require_relative "local"
+require_relative "local_pack_rank"
+require_relative "local_rank_grid"
+require_relative "log_analyzer"
+require_relative "mentions"
+require_relative "patches"
+require_relative "portfolios"
+require_relative "projects"
+require_relative "rank_tracking"
+require_relative "report_builder"
+require_relative "team"
+require_relative "usage"
+require_relative "web_analytics"
+require_relative "yandex"
+
+module MisarSEO
+  module Generated
+    # Client attribute name => resource class.
+    RESOURCES = {
+      account: AccountResource,
+      activity: ActivityResource,
+      ahrefs: AhrefsResource,
+      ai_search: AiSearchResource,
+      backlinks: BacklinksResource,
+      baidu: BaiduResource,
+      bing: BingResource,
+      brave_search: BraveSearchResource,
+      competitor_monitor: CompetitorMonitorResource,
+      competitors: CompetitorsResource,
+      content: ContentResource,
+      crawl: CrawlResource,
+      dashboard: DashboardResource,
+      direct_vendor_ai: DirectVendorAiResource,
+      disavow: DisavowResource,
+      domain: DomainResource,
+      ga4: Ga4Resource,
+      google_business_profile: GoogleBusinessProfileResource,
+      gsc: GscResource,
+      index_now: IndexNowResource,
+      keywords: KeywordsResource,
+      link_building: LinkBuildingResource,
+      local: LocalResource,
+      local_pack_rank: LocalPackRankResource,
+      local_rank_grid: LocalRankGridResource,
+      log_analyzer: LogAnalyzerResource,
+      mentions: MentionsResource,
+      patches: PatchesResource,
+      portfolios: PortfoliosResource,
+      projects: ProjectsResource,
+      rank_tracking: RankTrackingResource,
+      report_builder: ReportBuilderResource,
+      team: TeamResource,
+      usage: UsageResource,
+      web_analytics: WebAnalyticsResource,
+      yandex: YandexResource,
+    }.freeze
+  end
+end

data/lib/misarseo/generated/team.rb

@@ -0,0 +1,20 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.team+ — 1 endpoint(s).
+    class TeamResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # GET /team/members
+      def list_members(query: nil)
+        @transport.request("GET", "/team/members", query: query, body: nil)
+      end
+    end
+  end
+end

data/lib/misarseo/generated/usage.rb

@@ -0,0 +1,20 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.usage+ — 1 endpoint(s).
+    class UsageResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # GET /usage
+      def get(query: nil)
+        @transport.request("GET", "/usage", query: query, body: nil)
+      end
+    end
+  end
+end

data/lib/misarseo/generated/web_analytics.rb

@@ -0,0 +1,35 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.web_analytics+ — 4 endpoint(s).
+    class WebAnalyticsResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # POST /web-analytics/devices
+      def devices(body = nil, query: nil, **fields)
+        @transport.request("POST", "/web-analytics/devices", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /web-analytics/sources
+      def sources(body = nil, query: nil, **fields)
+        @transport.request("POST", "/web-analytics/sources", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /web-analytics/summary
+      def summary(body = nil, query: nil, **fields)
+        @transport.request("POST", "/web-analytics/summary", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /web-analytics/top-pages
+      def top_pages(body = nil, query: nil, **fields)
+        @transport.request("POST", "/web-analytics/top-pages", query: query, body: Transport.body(body, fields))
+      end
+    end
+  end
+end

data/lib/misarseo/generated/yandex.rb

@@ -0,0 +1,45 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.yandex+ — 6 endpoint(s).
+    class YandexResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # GET /yandex/connection
+      def connect(project_id, query: nil)
+        @transport.request("GET", "/yandex/connection", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # DELETE /yandex/connection
+      def disconnect(body = nil, query: nil, **fields)
+        @transport.request("DELETE", "/yandex/connection", query: query, body: Transport.body(body, fields))
+      end
+
+      # GET /yandex/hosts
+      def list_hosts(project_id, query: nil)
+        @transport.request("GET", "/yandex/hosts", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # POST /yandex/reindex-url
+      def reindex_url(body = nil, query: nil, **fields)
+        @transport.request("POST", "/yandex/reindex-url", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /yandex/connection
+      def set_host(body = nil, query: nil, **fields)
+        @transport.request("POST", "/yandex/connection", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /yandex/site-overview
+      def site_overview(body = nil, query: nil, **fields)
+        @transport.request("POST", "/yandex/site-overview", query: query, body: Transport.body(body, fields))
+      end
+    end
+  end
+end

data/lib/misarseo/pagination.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module MisarSEO
+  # The API's two pagination shapes. Offset pages (rows, hasMore, page)
+  # address rows by position; keyset pages (rows, hasMore, nextCursor) by key,
+  # so they never skip or repeat when rows are inserted mid-walk.
+  module Pagination
+    module_function
+
+    # Every row of an offset-paginated endpoint, page by page.
+    def collect_offset_pages(start_page = 1)
+      rows = []
+      page = start_page
+      loop do
+        result = yield(page) || {}
+        batch = Array(result["rows"])
+        rows.concat(batch)
+        return rows if !result["hasMore"] || batch.empty?
+
+        page += 1
+      end
+    end
+
+    # Every row following nextCursor; stops when it is absent or repeats.
+    def collect_cursor_pages(start_cursor = nil)
+      rows = []
+      cursor = start_cursor
+      loop do
+        result = yield(cursor) || {}
+        rows.concat(Array(result["rows"]))
+        nxt = result["nextCursor"]
+        return rows if !result["hasMore"] || nxt.nil? || nxt == cursor
+
+        cursor = nxt
+      end
+    end
+  end
+end

data/lib/misarseo/transport.rb

@@ -0,0 +1,192 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+module MisarSEO
+  # One Server-Sent Events frame.
+  Event = Struct.new(:event, :data)
+
+  # Request plumbing the generated resources are written against.
+  #
+  # Retry policy, identical in every MisarSEO SDK: 429 is retried for every
+  # verb unless the body says plan_limit_exceeded; 502/503/504 and network
+  # failures are retried for GET only (a POST may have started a billed
+  # crawl); backoff starts at 250 ms with jitter and honours Retry-After up to
+  # the configured cap.
+  #
+  # +adapter+ is anything responding to
+  # +call(method, url, headers, body) -> [status, headers, body_string]+;
+  # the default is Net::HTTP. Tests inject a recorder.
+  class Transport
+    DEFAULT_BASE_URL = "https://api.misar.io/seo"
+
+    def self.seg(value)
+      URI.encode_www_form_component(value.to_s).gsub("+", "%20")
+    end
+
+    # The JSON body of a call. Ruby 3 binds a brace-less trailing hash
+    # (+create("name" => "x")+) to keyword arguments, not to the positional
+    # +body+, so every body method also takes +**fields+ and they land here.
+    # Both spellings, and +create(name: "x")+, therefore send the same body.
+    def self.body(body, fields)
+      return body if fields.empty?
+      unless body.nil? || body.is_a?(Hash)
+        raise ArgumentError, "pass the request body as one Hash or as keyword fields, not both"
+      end
+
+      (body || {}).transform_keys(&:to_s).merge(fields.transform_keys(&:to_s))
+    end
+
+    # Required query parameters first; an explicit key in +query+ wins.
+    def self.merge(query, required)
+      required.merge((query || {}).transform_keys(&:to_s))
+    end
+
+    def initialize(api_key:, base_url: DEFAULT_BASE_URL, timeout: 30, max_retries: 2,
+                   retry_base_delay: 0.25, max_retry_delay: 60, adapter: nil)
+      @api_key = api_key
+      @base_url = base_url.sub(%r{/+\z}, "")
+      @timeout = timeout
+      @max_retries = max_retries
+      @retry_base_delay = retry_base_delay
+      @max_retry_delay = max_retry_delay
+      @adapter = adapter || method(:net_http)
+    end
+
+    def headers(accept = "application/json")
+      {
+        "Authorization" => "Bearer #{@api_key}",
+        "Content-Type" => "application/json",
+        "Accept" => accept,
+        "User-Agent" => "misarseo-ruby/#{VERSION}"
+      }
+    end
+
+    def url(path, query)
+      q = (query || {}).reject { |_, v| v.nil? }
+      return "#{@base_url}#{path}" if q.empty?
+
+      "#{@base_url}#{path}?" + q.map { |k, v| "#{Transport.seg(k)}=#{Transport.seg(v)}" }.join("&")
+    end
+
+    def request(method, path, query: nil, body: nil)
+      target = url(path, query)
+      payload = body.nil? ? nil : JSON.generate(body)
+      attempt = 0
+      loop do
+        begin
+          status, resp_headers, raw = @adapter.call(method, target, headers, payload)
+        rescue StandardError => e
+          raise NetworkError.new(0, "NETWORK_ERROR", "could not reach the MisarSEO API: #{e.message}") \
+            unless method == "GET" && attempt < @max_retries
+
+          sleep(backoff(attempt, nil))
+          attempt += 1
+          next
+        end
+        return decode(raw) if status.between?(200, 299)
+
+        error = MisarSEO.error_from(status, resp_headers, decode(raw))
+        retryable = status == 429 || (method == "GET" && [502, 503, 504].include?(status))
+        raise error if error.is_a?(PlanLimitError) || !retryable || attempt >= @max_retries
+
+        wait = backoff(attempt, error.retry_after)
+        raise error if wait.nil?
+
+        sleep(wait)
+        attempt += 1
+      end
+    end
+
+    # GET a text/event-stream endpoint, yielding Event frames until a terminal one.
+    def stream(path, query: nil, terminal: %w[complete error])
+      buffer = +""
+      done = false
+      @adapter.call("GET", url(path, query), headers("text/event-stream"), nil) do |status, resp_headers, chunk|
+        next if done
+
+        unless status.between?(200, 299)
+          raise MisarSEO.error_from(status, resp_headers, decode(chunk))
+        end
+
+        buffer << chunk.to_s.delete("\r")
+        while (idx = buffer.index("\n\n"))
+          frame = buffer.slice!(0, idx + 2)
+          event = Transport.parse_frame(frame)
+          next unless event
+
+          yield event
+          if terminal.include?(event.event)
+            done = true
+            break
+          end
+        end
+      end
+      event = Transport.parse_frame(buffer) unless done
+      yield event if event
+      nil
+    end
+
+    # Decode one SSE frame; nil for keep-alive comments and frames without an event line.
+    def self.parse_frame(frame)
+      name = nil
+      data = []
+      frame.to_s.split("\n").each do |line|
+        next if line.empty? || line.start_with?(":")
+
+        if line.start_with?("event:")
+          name = line[6..-1].strip
+        elsif line.start_with?("data:")
+          data << line[5..-1].sub(/\A +/, "")
+        end
+      end
+      return nil unless name
+
+      text = data.join("\n")
+      value = begin
+        text.empty? ? text : JSON.parse(text)
+      rescue JSON::ParserError
+        text
+      end
+      Event.new(name, value)
+    end
+
+    private
+
+    def decode(text)
+      return nil if text.nil? || text.strip.empty?
+
+      JSON.parse(text)
+    rescue JSON::ParserError
+      text
+    end
+
+    def backoff(attempt, retry_after)
+      return (retry_after > @max_retry_delay ? nil : retry_after) if retry_after
+
+      base = @retry_base_delay * (2**attempt)
+      [@max_retry_delay, base / 2.0 + rand * base / 2.0].min
+    end
+
+    def net_http(method, target, headers, payload, &block)
+      uri = URI(target)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = @timeout
+      http.read_timeout = block ? nil : @timeout
+      klass = Net::HTTP.const_get(method.capitalize)
+      req = klass.new(uri.request_uri, headers)
+      req.body = payload if payload
+      if block
+        http.request(req) do |resp|
+          resp.read_body { |chunk| block.call(resp.code.to_i, resp.to_hash, chunk) }
+        end
+        return
+      end
+      resp = http.request(req)
+      [resp.code.to_i, resp.to_hash, resp.body]
+    end
+  end
+end

data/lib/misarseo/version.rb

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

data/lib/misarseo.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "misarseo/version"
+require_relative "misarseo/errors"
+require_relative "misarseo/transport"
+require_relative "misarseo/pagination"
+require_relative "misarseo/generated/resources"
+require_relative "misarseo/client"
+
+# MisarSEO API client for Ruby: keyword research, site audits, rank tracking,
+# backlinks, AI search visibility, Search Console, GA4 and Business Profile.
+module MisarSEO
+end