vesremont-api 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e07ced12c291d62c82ec63a10fa8c7f52230f62bca85208f7915cc17752e7eff
+  data.tar.gz: e60ba737b7dcbe5351bd3fdf936dc50e0a2a05a060e8409e7ba948fb3d5a8fba
+SHA512:
+  metadata.gz: 3d17a0c4bfdc0107b7e1a8367d43684898a27b699d6d8fe8904b48e5689fde570e06e0c0bbbc296e3d299f813f823cc7b4d03bbb51aa58527e969f204b23dac1
+  data.tar.gz: f334266d48d8739000855bfb170c144965d762f6846044d1eeec4701b75ea63319d3bd559eaa27972a5a3b5ab36bee03da1d25716a3ee7fc67fd416514de92a9

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vesremont
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,39 @@
+# Vesremont Ruby SDK 0.2.0
+
+Ruby 3.3+, MIT, без сторонних runtime-зависимостей. Официальные исходники:
+https://github.com/oooafganec-dev/vesremont-sdk/tree/main/ruby.
+Команда установки опубликованного релиза из RubyGems:
+
+```bash
+gem install vesremont-api --version 0.2.0
+```
+
+Альтернатива — прямой gem с сайта Vesremont:
+
+```bash
+curl -fLO https://vesremont.com/developers/downloads/vesremont-api-0.2.0.gem
+gem install ./vesremont-api-0.2.0.gem --local
+```
+
+```ruby
+require 'vesremont_api'
+api = Vesremont::Client.new
+products = api.search('труборез', per_page: 10)
+product = api.product(375094)
+draft = api.cart_draft(375094, 1)
+```
+
+`status`, `search`, `product`, `cart`, `cart_draft` и общий
+`request(method, path, query: {}, body: nil, idempotency_key: nil)`.
+Путь относительно `/api/v1`, GET без body; JSON body — Hash.
+Личные операции: `Vesremont::Client.new(token: token)` с уже полученным REST
+OAuth token и минимальными scopes. OAuth мастер не дублируется (есть в Node CLI).
+Схемы сервера: https://vesremont.com/openapi.json.
+
+TLS проверяется; host фиксирован, redirects/автоматические повторы запрещены.
+Timeout 15 секунд по умолчанию, максимум 60; тело до 64 KiB, ответ до 2 MiB.
+`Vesremont::ApiError` содержит `status`, `code`, `request_id`, `retry_after` без
+raw response. Не логируйте token, share_url и личные ответы. Для submit нужны
+prepare, подтверждение покупателя и стабильный ключ; при сетевой ошибке сначала
+перечитайте состояние. Это production API, не sandbox. Запускать с внешнего ПК,
+не с сервера Vesremont. SDK не включает выключенные серверные интерфейсы.

data/lib/vesremont_api.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+require 'net/http'
+require 'json'
+require 'openssl'
+require 'timeout'
+
+module Vesremont
+  class ApiError < StandardError
+    attr_reader :status, :code, :request_id, :retry_after
+    def initialize(status, code, request_id = nil, retry_after = nil)
+      @status, @code, @request_id, @retry_after = status, code, request_id, retry_after
+      super("Vesremont: #{code} (HTTP #{status})")
+    end
+  end
+
+  class Client
+    ORIGIN = 'https://vesremont.com/api/v1'
+    MAX_REPLY = 2 * 1024 * 1024
+
+    def initialize(token: '', timeout: 15)
+      raise ArgumentError, 'Invalid access token' unless token.is_a?(String) && (token.empty? || token.match?(/\A[A-Za-z0-9_.~-]{1,8192}\z/))
+      raise ArgumentError, 'Timeout must be 0..60 seconds' unless timeout.is_a?(Numeric) && timeout.positive? && timeout <= 60
+      @token, @timeout = token.dup.freeze, timeout
+    end
+
+    def request(method, path, query: {}, body: nil, idempotency_key: nil)
+      raise ArgumentError, 'Invalid API method/path' unless %w[GET POST PATCH DELETE].include?(method) && path.is_a?(String) && path.match?(/\A\/[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*\/?\z/)
+      raise ArgumentError, 'JSON object required; GET body not supported' if !body.nil? && (method == 'GET' || !body.is_a?(Hash))
+      raise ArgumentError, 'Idempotency-Key is required' if method == 'POST' && path.delete_suffix('/') == '/orders/submit' && idempotency_key.nil?
+      if !idempotency_key.nil? && !(idempotency_key.is_a?(String) && idempotency_key.match?(/\A[A-Za-z0-9._:-]{16,128}\z/))
+        raise ArgumentError, 'Invalid idempotency key'
+      end
+      raise ArgumentError, 'Query must be a Hash' unless query.is_a?(Hash)
+      params = query.map do |name, value|
+        raise ArgumentError, 'Query values must be scalar' unless name.to_s.match?(/\A[a-z_]{1,40}\z/) && [String, Integer, Float, TrueClass, FalseClass].any? { |type| value.is_a?(type) }
+        [name.to_s, value.to_s]
+      end
+      encoded = URI.encode_www_form(params)
+      raise ArgumentError, 'Query exceeds 8192 characters' if encoded.bytesize > 8192
+      uri = URI(ORIGIN + path + (encoded.empty? ? '' : '?' + encoded))
+      payload = body.nil? ? nil : JSON.generate(body)
+      raise ArgumentError, 'Request body exceeds 64 KiB' if payload && payload.bytesize > 65536
+      req = Net::HTTPGenericRequest.new(method, !payload.nil?, true, uri.request_uri)
+      req['Accept'], req['User-Agent'] = 'application/json', 'Vesremont-Ruby/0.2.0'
+      req['Authorization'] = 'Bearer ' + @token unless @token.empty?
+      req['Idempotency-Key'] = idempotency_key unless idempotency_key.nil?
+      if payload
+        req['Content-Type'] = 'application/json'
+        req.body = payload
+      end
+      status, headers, raw = perform(uri, req)
+      begin
+        data = raw.empty? ? nil : JSON.parse(raw)
+      rescue JSON::ParserError
+        raise ApiError.new(status, 'invalid_json')
+      end
+      unless status.between?(200, 299)
+        problem = data.is_a?(Hash) ? data : {}
+        raise ApiError.new(status, safe(problem['code']) || 'http_error', safe(problem['request_id']), safe(headers['retry-after']))
+      end
+      data
+    end
+
+    def status = request('GET', '/status')
+    def cart = request('GET', '/cart')
+    def search(q, **query) = request('GET', '/products', query: query.merge(q: q))
+    def product(id) = request('GET', "/products/#{product_id(id)}")
+    def cart_draft(id, quantity = 1, draft: nil)
+      raise ArgumentError, 'Quantity must be 1..99' unless quantity.is_a?(Integer) && quantity.between?(1, 99)
+      query = { product_id: product_id(id), quantity: quantity }
+      query[:draft] = draft unless draft.nil?
+      request('GET', '/cart-drafts/', query: query)
+    end
+
+    private
+
+    def product_id(value)
+      raise ArgumentError, 'Positive product ID required' unless value.is_a?(Integer) && value.between?(1, 2_147_483_647)
+      value
+    end
+    def safe(value) = value.is_a?(String) && value.match?(/\A[A-Za-z0-9_.:-]{1,128}\z/) ? value : nil
+
+    def perform(uri, req)
+      http = Net::HTTP.new(uri.host, uri.port, nil)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+      http.open_timeout = http.read_timeout = http.write_timeout = @timeout
+      http.max_retries = 0
+      raw = +''
+      status = 0
+      headers = {}
+      Timeout.timeout(@timeout) do
+        http.start do |session|
+          session.request(req) do |response|
+            status, headers = response.code.to_i, response.to_hash.transform_values(&:first)
+            response.read_body do |chunk|
+              raise ApiError.new(status, 'response_too_large') if raw.bytesize + chunk.bytesize > MAX_REPLY
+              raw << chunk
+            end
+          end
+        end
+      end
+      [status, headers, raw]
+    rescue Timeout::Error, IOError, SystemCallError, SocketError, OpenSSL::SSL::SSLError, EOFError, Net::HTTPBadResponse, Net::ProtocolError
+      raise ApiError.new(0, 'transport_error')
+    end
+  end
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: vesremont-api
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Vesremont
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-10-05 00:00:00.000000000 Z
+dependencies: []
+description: Vesremont catalog and buyer-authorized REST operations with verified
+  TLS and no redirects.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/vesremont_api.rb
+homepage: https://vesremont.com/developers/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://vesremont.com/developers/
+  documentation_uri: https://vesremont.com/for_ai/api_ai/
+  source_code_uri: https://github.com/oooafganec-dev/vesremont-sdk/tree/main/ruby
+  bug_tracker_uri: https://github.com/oooafganec-dev/vesremont-sdk/issues
+  allowed_push_host: https://rubygems.org
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Bounded REST client for the Vesremont public API
+test_files: []