roistat 0.1.0

data/lib/roistat/response.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require "json"
+require "tempfile"
+
+class Roistat::Response
+  ERROR_MAP = {
+    "authentication_failed" => Roistat::AuthenticationError,
+    "authorization_failed" => Roistat::AuthorizationError,
+    "access_denied" => Roistat::AccessDeniedError,
+    "request_limit_error" => Roistat::RateLimitError
+  }.freeze
+
+  def self.parse(http_response, parse:, binary_tempfile_threshold:)
+    new(http_response, parse: parse, binary_tempfile_threshold: binary_tempfile_threshold).parse
+  end
+
+  def initialize(http_response, parse:, binary_tempfile_threshold:)
+    @http_response = http_response
+    @parse = parse
+    @binary_tempfile_threshold = binary_tempfile_threshold
+  end
+
+  def parse
+    raise_transport_error! if transport_failure?
+
+    body = @http_response.body.to_s
+    return parse_binary(body) if @parse == :binary
+
+    parsed = parse_json(body)
+    raise_api_error!(parsed) if api_error?(parsed)
+    parsed
+  end
+
+  private
+
+  def transport_failure?
+    return false unless @http_response.respond_to?(:error) && @http_response.error
+
+    # HTTP status errors (4xx/5xx) still expose a body — map them via JSON.
+    !@http_response.respond_to?(:status) || @http_response.status.nil?
+  end
+
+  def raise_transport_error!
+    raise Roistat::Error, @http_response.error.message
+  end
+
+  def parse_json(body)
+    return {} if body.nil? || body.empty?
+
+    JSON.parse(body)
+  rescue JSON::ParserError => e
+    raise Roistat::Error, "Invalid JSON response: #{e.message}"
+  end
+
+  def api_error?(parsed)
+    parsed.is_a?(Hash) && parsed["status"].to_s == "error"
+  end
+
+  def raise_api_error!(parsed)
+    code = parsed["error"].to_s
+    error_class = ERROR_MAP.fetch(code, Roistat::Error)
+    raise error_class.new(
+      "Roistat API error: #{code}",
+      code: code,
+      http_status: @http_response.status,
+      response_body: parsed
+    )
+  end
+
+  def parse_binary(body)
+    size = content_length || body.bytesize
+    return body if size <= @binary_tempfile_threshold
+
+    tempfile = Tempfile.new(["roistat", ".bin"], binmode: true)
+    tempfile.write(body.b)
+    tempfile.rewind
+    tempfile
+  end
+
+  def content_length
+    headers = @http_response.headers
+    value = headers["content-length"] || headers["Content-Length"]
+    Integer(value) if value
+  rescue ArgumentError, TypeError
+    nil
+  end
+end

data/lib/roistat/version.rb

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

data/lib/roistat.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require_relative "roistat/version"
+require_relative "roistat/errors"
+require_relative "roistat/configuration"
+require_relative "roistat/response"
+require_relative "roistat/client"
+
+module Roistat::Resources
+end
+
+require_relative "roistat/resources/base"
+require_relative "roistat/resources/projects"
+require_relative "roistat/resources/access"
+require_relative "roistat/resources/dashboards"
+require_relative "roistat/resources/widgets"
+require_relative "roistat/resources/billing"
+require_relative "roistat/resources/calltracking"
+require_relative "roistat/resources/orders"
+require_relative "roistat/resources/proxy_leads"
+require_relative "roistat/resources/leads"
+require_relative "roistat/resources/managers"
+require_relative "roistat/resources/clients"
+require_relative "roistat/resources/visits"
+require_relative "roistat/resources/events"
+require_relative "roistat/resources/analytics"
+require_relative "roistat/resources/channels"
+require_relative "roistat/resources/statistics"
+require_relative "roistat/resources/indicators"
+require_relative "roistat/resources/lead_hunter"
+require_relative "roistat/resources/emailtracking"
+require_relative "roistat/resources/sms"
+require_relative "roistat/resources/mediaplan"
+require_relative "roistat/resources/speech"
+require_relative "roistat/resources/vpbx"
+
+module Roistat
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield configuration
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+      @client = nil
+    end
+
+    def client
+      @client ||= Client.new(
+        api_key: configuration.api_key,
+        project: configuration.project,
+        base_url: configuration.base_url,
+        timeout: configuration.timeout,
+        open_timeout: configuration.open_timeout,
+        binary_tempfile_threshold: configuration.binary_tempfile_threshold
+      )
+    end
+  end
+end
+
+module Roistat::Generators
+end

data/mise.toml

@@ -0,0 +1,14 @@
+[tools]
+ruby = "4.0.6"
+
+[tasks.test]
+description = "Run the RSpec suite"
+run = "bundle exec rake spec"
+
+[tasks.lint]
+description = "Run RuboCop"
+run = "bundle exec rubocop"
+
+[tasks.release]
+description = "Build and publish the gem (rake release)"
+run = "bundle exec rake release"

data/sig/roistat.rbs

@@ -0,0 +1,251 @@
+module Roistat
+  VERSION: String
+
+  def self.configuration: () -> Configuration
+  def self.configure: () { (Configuration) -> void } -> void
+  def self.reset_configuration!: () -> void
+  def self.client: () -> Client
+end
+
+class Roistat::Configuration
+  DEFAULT_BASE_URL: String
+  attr_accessor api_key: String?
+  attr_accessor project: String?
+  attr_accessor base_url: String
+  attr_accessor timeout: Integer
+  attr_accessor open_timeout: Integer
+  attr_accessor binary_tempfile_threshold: Integer
+end
+
+class Roistat::Client
+  def initialize: (
+    api_key: String,
+    ?project: String?,
+    ?project_required: bool,
+    ?base_url: String?,
+    ?timeout: Integer?,
+    ?open_timeout: Integer?,
+    ?binary_tempfile_threshold: Integer?
+  ) -> void
+
+  def get: (String, ?params: Hash[Symbol | String, untyped], ?parse: Symbol) -> untyped
+  def post: (String, ?params: Hash[Symbol | String, untyped], ?body: untyped, ?parse: Symbol) -> untyped
+  def post_multipart: (String, ?params: Hash[Symbol | String, untyped], ?form: Hash[Symbol | String, untyped], ?parse: Symbol) -> untyped
+  def request: (Symbol | String, String, ?params: Hash[Symbol | String, untyped], ?body: untyped, ?parse: Symbol) -> untyped
+
+  def projects: () -> Roistat::Resources::Projects
+  def access: () -> Roistat::Resources::Access
+  def dashboards: () -> Roistat::Resources::Dashboards
+  def widgets: () -> Roistat::Resources::Widgets
+  def billing: () -> Roistat::Resources::Billing
+  def calltracking: () -> Roistat::Resources::Calltracking
+  def orders: () -> Roistat::Resources::Orders
+  def proxy_leads: () -> Roistat::Resources::ProxyLeads
+  def leads: () -> Roistat::Resources::Leads
+  def managers: () -> Roistat::Resources::Managers
+  def clients: () -> Roistat::Resources::Clients
+  def visits: () -> Roistat::Resources::Visits
+  def events: () -> Roistat::Resources::Events
+  def analytics: () -> Roistat::Resources::Analytics
+  def channels: () -> Roistat::Resources::Channels
+  def statistics: () -> Roistat::Resources::Statistics
+  def indicators: () -> Roistat::Resources::Indicators
+  def lead_hunter: () -> Roistat::Resources::LeadHunter
+  def emailtracking: () -> Roistat::Resources::Emailtracking
+  def sms: () -> Roistat::Resources::Sms
+  def mediaplan: () -> Roistat::Resources::Mediaplan
+  def speech: () -> Roistat::Resources::Speech
+  def vpbx: () -> Roistat::Resources::Vpbx
+end
+
+class Roistat::Resources::Projects
+  def list: () -> untyped
+  def create: (name: String, currency: String) -> untyped
+  def modules_list: (?method: Symbol) -> untyped
+  def counter_list: () -> untyped
+end
+
+class Roistat::Resources::Access
+  def user_list: () -> untyped
+  def authorized_users: (?method: Symbol) -> untyped
+  def change: (**untyped) -> untyped
+end
+
+class Roistat::Resources::Dashboards
+  def list: () -> untyped
+  def widgets: (dashboard_id: Integer | String) -> untyped
+end
+
+class Roistat::Resources::Widgets
+  def data: (widget_id: Integer | String, ?method: Symbol, **untyped) -> untyped
+end
+
+class Roistat::Resources::Calltracking
+  def script_list: (**untyped) -> untyped
+  def script_create: (**untyped) -> untyped
+  def script_update: (**untyped) -> untyped
+  def script_delete: (id: Integer | String) -> untyped
+  def phone_list: (**untyped) -> untyped
+  def phone_prefix_list: (**untyped) -> untyped
+  def phone_create: (phones: Array[String]) -> untyped
+  def phone_buy: (prefix: String, count: Integer) -> untyped
+  def phone_update: (**untyped) -> untyped
+  def phone_delete: (phones: Array[Integer | String]) -> untyped
+  def call_list: (**untyped) -> untyped
+  def call_update: (**untyped) -> untyped
+  def call_delete: (ids: Array[Integer | String]) -> untyped
+  def call_file: (call_id: Integer | String) -> untyped
+  def call_xls_export: (period: Hash[Symbol | String, untyped]) -> untyped
+  def data: (period: Hash[Symbol | String, untyped]) -> untyped
+  def phone_call: (**untyped) -> untyped
+end
+
+class Roistat::Resources::Orders
+  def list: (**untyped) -> untyped
+  def add: (Array[untyped]) -> untyped
+  def info: (order_id: Integer | String) -> untyped
+  def external_url: (order_id: Integer | String) -> untyped
+  def status_list: (**untyped) -> untyped
+  def set_statuses: (Array[untyped]) -> untyped
+  def custom_fields: (**untyped) -> untyped
+  def status_update: (order_id: Integer | String, status_id: Integer | String) -> untyped
+  def goal_update: (order_id: Integer | String, **untyped) -> untyped
+  def update: (orders: Array[untyped]) -> untyped
+  def delete: (order_id: Integer | String) -> untyped
+  def delete_many: (ids: Array[Integer | String]) -> untyped
+end
+
+class Roistat::Resources::ProxyLeads
+  def list: (period: String) -> untyped
+  def duplicates: (period: String) -> untyped
+  def get: (id: Integer | String) -> untyped
+end
+
+class Roistat::Resources::Leads
+  def list: (**untyped) -> untyped
+  def status_list: (**untyped) -> untyped
+  def create: (**untyped) -> untyped
+  def update: (**untyped) -> untyped
+end
+
+class Roistat::Resources::Managers
+  def list: (**untyped) -> untyped
+  def add: (**untyped) -> untyped
+  def update: (**untyped) -> untyped
+  def delete: (id: Integer | String) -> untyped
+end
+
+class Roistat::Resources::Clients
+  def list: (**untyped) -> untyped
+  def import: (Array[untyped]) -> untyped
+  def detail_feed: (client: Integer | String) -> untyped
+  def campaign_list: (**untyped) -> untyped
+  def campaign_contact_list: (**untyped) -> untyped
+end
+
+class Roistat::Resources::Visits
+  def list: (**untyped) -> untyped
+  def params_update: (**untyped) -> untyped
+end
+
+class Roistat::Resources::Events
+  def send_event: (**untyped) -> untyped
+  def bulk_send: (Array[untyped]) -> untyped
+  def add: (Array[untyped]) -> untyped
+  def log: (**untyped) -> untyped
+  def archive: (event_id: Integer | String, events: Array[untyped]) -> untyped
+end
+
+class Roistat::Resources::Analytics
+  def data: (**untyped) -> untyped
+  def data_export_excel: (**untyped) -> untyped
+  def metrics_new: (**untyped) -> untyped
+  def dimensions: (**untyped) -> untyped
+  def dimension_values: (**untyped) -> untyped
+  def attribution_models: (**untyped) -> untyped
+  def list_orders: (**untyped) -> untyped
+  def custom_metrics_list: (**untyped) -> untyped
+  def custom_manual_value_list: (**untyped) -> untyped
+  def custom_manual_value_add: (**untyped) -> untyped
+  def custom_manual_value_delete: (**untyped) -> untyped
+  def funnel_data: (**untyped) -> untyped
+  def event_add: (**untyped) -> untyped
+end
+
+class Roistat::Resources::Channels
+  def source_list: (**untyped) -> untyped
+  def cost_list: (**untyped) -> untyped
+  def cost_add: (**untyped) -> untyped
+  def cost_update: (**untyped) -> untyped
+  def cost_delete: (id: Integer | String) -> untyped
+end
+
+class Roistat::Resources::Statistics
+  def get_daily: (**untyped) -> untyped
+end
+
+class Roistat::Resources::Indicators
+  def list: () -> untyped
+  def run_script: (indicator_id: Integer | String) -> untyped
+end
+
+class Roistat::Resources::LeadHunter
+  def list: (**untyped) -> untyped
+end
+
+class Roistat::Resources::Emailtracking
+  def list: (**untyped) -> untyped
+  def attachment: (email_id: Integer | String, attachment_id: Integer | String) -> untyped
+end
+
+class Roistat::Resources::Sms
+  def set_report_enabled: (enabled: bool | Integer | String) -> untyped
+end
+
+class Roistat::Resources::Mediaplan
+  def target_list: (**untyped) -> untyped
+  def target_create: (**untyped) -> untyped
+  def target_update: (**untyped) -> untyped
+  def target_delete: (id: Integer | String) -> untyped
+end
+
+class Roistat::Resources::Speech
+  def call_list: (**untyped) -> untyped
+  def call_list_export_excel: (**untyped) -> untyped
+  def call_add: (**untyped) -> untyped
+  def call_comment_update: (**untyped) -> untyped
+  def call_operator_update: (**untyped) -> untyped
+  def call_transcription_list: (**untyped) -> untyped
+  def dictionary_list: (**untyped) -> untyped
+  def dictionary_custom_create: (**untyped) -> untyped
+  def dictionary_custom_update: (**untyped) -> untyped
+  def dictionary_custom_delete: (**untyped) -> untyped
+  def dictionary_custom_phrase_list: (**untyped) -> untyped
+  def settings_list: (**untyped) -> untyped
+  def settings_update: (**untyped) -> untyped
+end
+
+class Roistat::Resources::Vpbx
+  def call_list: (**untyped) -> untyped
+  def operator_list: (**untyped) -> untyped
+  def operator_create: (**untyped) -> untyped
+  def operator_update: (**untyped) -> untyped
+  def operator_deactivate: (**untyped) -> untyped
+  def operator_group_list: (**untyped) -> untyped
+  def operator_group_create: (**untyped) -> untyped
+  def operator_group_update: (**untyped) -> untyped
+  def phone_list: (**untyped) -> untyped
+  def phone_create: (**untyped) -> untyped
+  def phone_update: (**untyped) -> untyped
+  def phone_delete: (**untyped) -> untyped
+  def script_list: (**untyped) -> untyped
+  def script_create: (**untyped) -> untyped
+  def script_update: (**untyped) -> untyped
+  def script_delete: (**untyped) -> untyped
+  def report_data: (**untyped) -> untyped
+  def settings_update: (**untyped) -> untyped
+  def settings_file_audio_upload: (file: IO, **untyped) -> untyped
+end
+
+class Roistat::Error < StandardError
+end

metadata

@@ -0,0 +1,187 @@
+--- !ruby/object:Gem::Specification
+name: roistat
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alexey Poimtsev
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httpx
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: lefthook
+  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: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Ruby wrapper for the Roistat REST API. Configure with an API key and
+  project id, then call documented Roistat endpoints through resource helpers or low-level
+  get/post.
+email:
+- alexey.poimtsev@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ruby-version"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- docs/ru/README.md
+- lefthook.yml
+- lib/generators/roistat/install/install_generator.rb
+- lib/generators/roistat/install/templates/roistat.rb
+- lib/roistat.rb
+- lib/roistat/client.rb
+- lib/roistat/configuration.rb
+- lib/roistat/errors.rb
+- lib/roistat/resources/access.rb
+- lib/roistat/resources/analytics.rb
+- lib/roistat/resources/base.rb
+- lib/roistat/resources/billing.rb
+- lib/roistat/resources/calltracking.rb
+- lib/roistat/resources/channels.rb
+- lib/roistat/resources/clients.rb
+- lib/roistat/resources/dashboards.rb
+- lib/roistat/resources/emailtracking.rb
+- lib/roistat/resources/events.rb
+- lib/roistat/resources/indicators.rb
+- lib/roistat/resources/lead_hunter.rb
+- lib/roistat/resources/leads.rb
+- lib/roistat/resources/managers.rb
+- lib/roistat/resources/mediaplan.rb
+- lib/roistat/resources/orders.rb
+- lib/roistat/resources/projects.rb
+- lib/roistat/resources/proxy_leads.rb
+- lib/roistat/resources/sms.rb
+- lib/roistat/resources/speech.rb
+- lib/roistat/resources/statistics.rb
+- lib/roistat/resources/visits.rb
+- lib/roistat/resources/vpbx.rb
+- lib/roistat/resources/widgets.rb
+- lib/roistat/response.rb
+- lib/roistat/version.rb
+- mise.toml
+- sig/roistat.rbs
+homepage: https://github.com/alec-c4/roistat
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/alec-c4/roistat
+  source_code_uri: https://github.com/alec-c4/roistat
+  changelog_uri: https://github.com/alec-c4/roistat/blob/master/CHANGELOG.md
+  documentation_uri: https://github.com/alec-c4/roistat/blob/master/README.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.17
+specification_version: 4
+summary: Ruby wrapper for the Roistat REST API.
+test_files: []