apigratis-sdk-ruby 0.0.1

data/lib/api_brasil/legacy/service.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+
+require_relative "../core/http_client"
+
+module ApiBrasil
+  # Interface legada da SDK: metodos de classe por servico, sempre com o
+  # mesmo contrato (`{ "Bearer" => ..., "DeviceToken" => ..., "body" => {...} }`)
+  # e resposta decodificada - erros HTTP nunca levantam excecao, sao
+  # devolvidos como o proprio corpo da resposta.
+  #
+  # @deprecated Prefira `ApiBrasil.new(...)`, que cobre toda a plataforma
+  #   (WhatsApp, SMS, consultas, pagamentos, relatorios) com metodos
+  #   dedicados, erros tipados, retry e hooks. Esta classe existe para
+  #   quem esta migrando das SDKs PHP/Node com o contrato antigo.
+  module Legacy
+    class Service
+      BASE_URI = "https://gateway.apibrasil.io/api/v2"
+
+      class << self
+        # `POST /servers`
+        def server(data = {})
+          call("servers", data)
+        end
+
+        # `POST /{action}` (ex: `login`, `logout`)
+        def auth(action = "", data = {})
+          call(action, data)
+        end
+
+        # `POST /plan` (action `me`) ou `POST /plans/{action}`
+        def plan(action = "", data = {})
+          return call("plan", data) if action.to_s == "me"
+
+          call(join("plans", action), data)
+        end
+
+        # `POST /profile`
+        def profile(data = {})
+          call("profile", data)
+        end
+
+        # `POST /devices/{action}`
+        def device(action = "", data = {})
+          call(join("devices", action), data)
+        end
+
+        # `POST /whatsapp/{action}`
+        def whatsapp(action = "", data = {})
+          call(join("whatsapp", action), data)
+        end
+
+        # `POST /vehicles/{action}` - normaliza o campo `tipo` como na SDK PHP.
+        def vehicles(action = "", data = {})
+          normalized = Core::HttpClient.normalize_keys(data)
+          action = action.to_s.sub(%r{\A/+}, "")
+          body = normalized[:body] || {}
+
+          body = { "tipo" => normalized[:tipo].to_s }.merge(body) if normalized[:tipo] && !key?(body, "tipo")
+          body = normalize_tipo_body(body) if action.start_with?("base/")
+
+          call(join("vehicles", action), data, {}, body)
+        end
+
+        # `POST /correios/{action}`
+        def correios(action = "", data = {})
+          call(join("correios", action), data)
+        end
+
+        # `POST /dados/{action}` (mantido com o nome antigo `cnpj`)
+        def cnpj(action = "", data = {})
+          call(join("dados", action), data)
+        end
+
+        # `POST /cep/{action}`
+        def cep(action = "", data = {})
+          call(join("cep", action), data)
+        end
+
+        # `POST /holidays/{action}`
+        def holidays(action = "", data = {})
+          call(join("holidays", action), data)
+        end
+
+        # `POST /ddd/{action}`
+        def ddd(action = "", data = {})
+          call(join("ddd", action), data)
+        end
+
+        private
+
+        def join(prefix, action)
+          action = action.to_s.sub(%r{\A/+}, "")
+          action.empty? ? prefix : "#{prefix}/#{action}"
+        end
+
+        def key?(hash, name)
+          hash.is_a?(Hash) && (hash.key?(name) || hash.key?(name.to_sym))
+        end
+
+        # `{ "lista-socios" => { "cnpj" => "..." } }` vira
+        # `{ "tipo" => "lista-socios", "cnpj" => "..." }`.
+        def normalize_tipo_body(body)
+          return body unless body.is_a?(Hash)
+          return body if key?(body, "tipo")
+          return body unless body.size == 1
+
+          tipo, payload = body.first
+          return body unless tipo.is_a?(String) && !tipo.empty? && payload.is_a?(Hash)
+
+          { "tipo" => tipo }.merge(payload)
+        end
+
+        def call(path, data = {}, extra_headers = {}, body = nil)
+          data = Core::HttpClient.normalize_keys(data)
+          method = (data[:method] || "POST").to_s.upcase
+          body ||= data[:body] || {}
+          body = nil if %w[GET HEAD].include?(method)
+
+          client(data).request(method, path, body, request_options(data, path, extra_headers))
+        rescue Core::Errors::ApiBrasilError => e
+          e.response.nil? ? { "error" => true, "message" => e.message } : e.response
+        end
+
+        def client(data)
+          Core::HttpClient.new(
+            base_url: data[:base_uri] || BASE_URI,
+            bearer_token: data[:bearer],
+            device_token: data[:device_token],
+            timeout: timeout_ms(data),
+            retry: false,
+            transport: data[:transport]
+          )
+        end
+
+        def request_options(data, path, extra_headers)
+          options = { headers: extra_headers || {} }
+          options[:secret_key] = data[:secret_key] if data[:secret_key]
+          options[:query] = data[:query] if data[:query].is_a?(Hash)
+          # Paridade com a SDK PHP: a rota crua `qrcode` devolve o conteudo
+          # sem decodificar (`whatsapp/qrcode` continua sendo JSON).
+          options[:response_type] = "raw" if path.to_s.split("?").first.to_s.gsub(%r{\A/+|/+\z}, "") == "qrcode"
+
+          options
+        end
+
+        # A interface antiga recebe segundos; o cliente novo usa milissegundos.
+        def timeout_ms(data)
+          seconds = data[:timeout] || 300
+
+          (seconds.to_f * 1000).to_i
+        end
+      end
+    end
+  end
+end

data/lib/api_brasil/services/base_service.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module ApiBrasil
+  module Services
+    # Base de todos os servicos - guarda o cliente HTTP compartilhado e
+    # expoe os atalhos por verbo.
+    class BaseService
+      # @return [ApiBrasil::Core::HttpClient]
+      attr_reader :http
+
+      # @param http [ApiBrasil::Core::HttpClient]
+      def initialize(http)
+        @http = http
+      end
+
+      # @return [Object]
+      def get(path, options = {})
+        http.get(path, options)
+      end
+
+      # @return [Object]
+      def post(path, body = nil, options = {})
+        http.post(path, body, options)
+      end
+
+      # @return [Object]
+      def put(path, body = nil, options = {})
+        http.put(path, body, options)
+      end
+
+      # @return [Object]
+      def patch(path, body = nil, options = {})
+        http.patch(path, body, options)
+      end
+
+      # @return [Object]
+      def delete(path, body = nil, options = {})
+        http.delete(path, body, options)
+      end
+
+      # Baixa os bytes crus de uma rota (PDF, imagens...).
+      #
+      # @return [String]
+      def download(path, options = {})
+        http.get(path, { response_type: "raw" }.merge(options))
+      end
+    end
+  end
+end

data/lib/api_brasil/services/data/bulk_service.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "../base_service"
+
+module ApiBrasil
+  module Services
+    module Data
+      # Execucao em lote: `/bulk/direct/{action}` e `/bulk/queue/{action}`.
+      class BulkService < BaseService
+        # Executa um lote de forma sincrona: `POST /bulk/direct/{action}`.
+        #
+        # @return [Object]
+        def direct(action, body, options = {})
+          post("/bulk/direct/#{action.to_s.sub(%r{\A/+}, "")}", body, options)
+        end
+
+        # Enfileira um lote: `POST /bulk/queue/{action}`.
+        #
+        # @return [Object]
+        def queue(action, body, options = {})
+          post("/bulk/queue/#{action.to_s.sub(%r{\A/+}, "")}", body, options)
+        end
+      end
+    end
+  end
+end

data/lib/api_brasil/services/data/cep_service.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative "../device_proxy_service"
+
+module ApiBrasil
+  module Services
+    module Data
+      # CEP + geolocalizacao (device-based): `/cep/{action}`.
+      class CepService < DeviceProxyService
+        def initialize(http)
+          super(http, "cep")
+        end
+
+        # Consulta um CEP: `POST /cep/cep` body `{"cep" => ...}`.
+        #
+        # @return [Object]
+        def cep(body, options = {})
+          request("cep", body, options)
+        end
+
+        # Bairros de uma cidade: `POST /cep/bairros`.
+        #
+        # @return [Object]
+        def bairros(body, options = {})
+          request("bairros", body, options)
+        end
+
+        # Cidades de um estado: `POST /cep/cidades`.
+        #
+        # @return [Object]
+        def cidades(body, options = {})
+          request("cidades", body, options)
+        end
+
+        # Cidades por DDD: `POST /cep/cidadesPorDDD`.
+        #
+        # @return [Object]
+        def cidades_por_ddd(body, options = {})
+          request("cidadesPorDDD", body, options)
+        end
+
+        # Estados: `POST /cep/estados`.
+        #
+        # @return [Object]
+        def estados(body = nil, options = {})
+          request("estados", body, options)
+        end
+
+        # Distancia entre CEPs: `POST /cep/distancia/calcular`.
+        #
+        # @return [Object]
+        def distancia(body, options = {})
+          request("distancia/calcular", body, options)
+        end
+      end
+    end
+  end
+end

data/lib/api_brasil/services/data/chip_virtual_service.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative "../base_service"
+
+module ApiBrasil
+  module Services
+    module Data
+      # Chip virtual: `/chip/virtual/*`.
+      class ChipVirtualService < BaseService
+        # Lista operadoras: `POST /chip/virtual/operators`.
+        #
+        # @return [Object]
+        def operators(body = nil, options = {})
+          post("/chip/virtual/operators", body, options)
+        end
+
+        # Compra um numero: `POST /chip/virtual/buy`.
+        #
+        # @return [Object]
+        def buy(body, options = {})
+          post("/chip/virtual/buy", body, options)
+        end
+
+        # Consulta ativacao: `POST /chip/virtual/activation`.
+        #
+        # @return [Object]
+        def activation(body, options = {})
+          post("/chip/virtual/activation", body, options)
+        end
+
+        # Lista servicos: `POST /chip/virtual/services`.
+        #
+        # @return [Object]
+        def services(body = nil, options = {})
+          post("/chip/virtual/services", body, options)
+        end
+      end
+    end
+  end
+end

data/lib/api_brasil/services/data/consulta_service.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require_relative "../base_service"
+
+module ApiBrasil
+  module Services
+    module Data
+      # Consultas por credito (`/consulta/{servico}/credits` e afins).
+      #
+      # Nao usam `DeviceToken` - debitam o saldo/creditos da conta.
+      # O campo `tipo` do body define o produto consultado (ex: `lista-socios`,
+      # `serasa-score-pf`, `spc-serasa`) - a lista completa esta em
+      # `ApiBrasil::Generated::Catalog::CONSULTA_TIPOS`. Use `homolog: true`
+      # para sandbox.
+      class ConsultaService < BaseService
+        # Consulta generica: `POST /consulta/{service}/credits`.
+        #
+        # @return [Object]
+        def generic(service, body = {}, options = {})
+          post("/consulta/#{service}/credits", body, options)
+        end
+
+        # Creditos disponiveis de um servico: `GET /consulta/{service}/credits`.
+        #
+        # @return [Object]
+        def credits(service, options = {})
+          get("/consulta/#{service}/credits", options)
+        end
+
+        # Consulta CPF: `POST /consulta/cpf/credits`.
+        #
+        # @return [Object]
+        def cpf(body, options = {})
+          generic("cpf", body, options)
+        end
+
+        # Consulta CNPJ: `POST /consulta/cnpj/credits` (ex: `tipo: "lista-socios"`).
+        #
+        # @return [Object]
+        def cnpj(body, options = {})
+          generic("cnpj", body, options)
+        end
+
+        # Consulta CNH: `POST /consulta/cnh/credits`.
+        #
+        # @return [Object]
+        def cnh(body, options = {})
+          generic("cnh", body, options)
+        end
+
+        # Consulta CEP: `POST /consulta/cep/credits`.
+        #
+        # @return [Object]
+        def cep(body, options = {})
+          generic("cep", body, options)
+        end
+
+        # Consulta veicular: `POST /consulta/veiculos/credits`.
+        #
+        # @return [Object]
+        def veiculos(body, options = {})
+          generic("veiculos", body, options)
+        end
+
+        # Consulta operadora de telefone: `POST /consulta/telefone/credits`.
+        #
+        # @return [Object]
+        def telefone(body, options = {})
+          generic("telefone", body, options)
+        end
+
+        # Consulta veicular nas bases dedicadas:
+        # `POST /vehicles/base/000/dados` | `POST /vehicles/base/000/fipe`.
+        #
+        # @param base [String] `dados` ou `fipe`
+        # @return [Object]
+        def veiculos_base(base, body, options = {})
+          post("/vehicles/base/000/#{base}", body, options)
+        end
+
+        # Distancia entre CEPs: `POST /cep/distancia/calcular`.
+        #
+        # @return [Object]
+        def cep_distancia(body, options = {})
+          post("/cep/distancia/calcular", body, options)
+        end
+
+        # Proxy seller: `POST /proxy/seller/credits`.
+        #
+        # @return [Object]
+        def proxy_seller(body = {}, options = {})
+          post("/proxy/seller/credits", body, options)
+        end
+      end
+    end
+  end
+end

data/lib/api_brasil/services/data/correios_service.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative "../device_proxy_service"
+
+module ApiBrasil
+  module Services
+    module Data
+      # Correios (device-based): `/correios/{action}`.
+      class CorreiosService < DeviceProxyService
+        def initialize(http)
+          super(http, "correios")
+        end
+
+        # Rastreio de encomendas: `POST /correios/rastreio` body `{"code" => ...}`.
+        #
+        # @return [Object]
+        def rastreio(body, options = {})
+          request("rastreio", body, options)
+        end
+      end
+    end
+  end
+end

data/lib/api_brasil/services/data/dados_service.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative "../device_proxy_service"
+
+module ApiBrasil
+  module Services
+    module Data
+      # Dados cadastrais (device-based): `/dados/{action}`.
+      class DadosService < DeviceProxyService
+        def initialize(http)
+          super(http, "dados")
+        end
+
+        # Consulta CNPJ: `POST /dados/cnpj` body `{"cnpj" => ...}`.
+        #
+        # @return [Object]
+        def cnpj(body, options = {})
+          request("cnpj", body, options)
+        end
+
+        # Consulta CPF: `POST /dados/cpf` body `{"cpf" => ...}`.
+        #
+        # @return [Object]
+        def cpf(body, options = {})
+          request("cpf", body, options)
+        end
+      end
+    end
+  end
+end

data/lib/api_brasil/services/data/database_ip_service.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative "../base_service"
+
+module ApiBrasil
+  module Services
+    module Data
+      # GeoIP (device-based): `POST /database/ip`.
+      class DatabaseIpService < BaseService
+        # Consulta a base de IPs: `POST /database/ip` body `{"ip" => ...}`.
+        #
+        # @return [Object]
+        def ip(body = nil, options = {})
+          post("/database/ip", body, options)
+        end
+      end
+    end
+  end
+end

data/lib/api_brasil/services/data/fipe_service.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require_relative "../device_proxy_service"
+
+module ApiBrasil
+  module Services
+    module Data
+      # Tabela FIPE (device-based): `/fipe/{action}` (marcas, modelos, anos, preco...).
+      #
+      # As actions documentadas estao em
+      # `ApiBrasil::Generated::Catalog.service_actions("fipe")`.
+      class FipeService < DeviceProxyService
+        def initialize(http)
+          super(http, "fipe")
+        end
+
+        # Tabela de referencia: `POST /fipe/ConsultarTabelaDeReferencia`.
+        #
+        # @return [Object]
+        def tabela_referencia(body = nil, options = {})
+          request("ConsultarTabelaDeReferencia", body, options)
+        end
+
+        # Marcas: `POST /fipe/ConsultarMarcas`.
+        #
+        # @return [Object]
+        def marcas(body, options = {})
+          request("ConsultarMarcas", body, options)
+        end
+
+        # Modelos: `POST /fipe/ConsultarModelos`.
+        #
+        # @return [Object]
+        def modelos(body, options = {})
+          request("ConsultarModelos", body, options)
+        end
+
+        # Anos de um modelo: `POST /fipe/ConsultarAnoModelo`.
+        #
+        # @return [Object]
+        def ano_modelo(body, options = {})
+          request("ConsultarAnoModelo", body, options)
+        end
+
+        # Modelos de um ano: `POST /fipe/ConsultarModelosAtravesDoAno`.
+        #
+        # @return [Object]
+        def modelos_por_ano(body, options = {})
+          request("ConsultarModelosAtravesDoAno", body, options)
+        end
+
+        # Valor com todos os parametros: `POST /fipe/ConsultarValorComTodosParametros`.
+        #
+        # @return [Object]
+        def valor(body, options = {})
+          request("ConsultarValorComTodosParametros", body, options)
+        end
+      end
+    end
+  end
+end