shelfwatch 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c88743581650ab50a89f0fb2b35a3fba38f1b674b7649ff672666d28f66f5a59
+  data.tar.gz: d5ac216d35acf1949856d1546dbf5733482e39d69fc67204cb6a18d5660dd8ba
+SHA512:
+  metadata.gz: 9d514a01d9b052a35d41544b6e79793341c7f23115110cc4d9d1ceca0a6ad36f7d709d4ed02cf2fa0a5f966075a1663d1cb170eca615acdb09d35e773459073d
+  data.tar.gz: 1c6e882c03f0a381e127b633ed38dd8f30681e3ef0660b2293bccb0b05083d8ac3b6e67c78e783e8647b18ec860d506f94864e880b1dd413f02fb645b4f8ff2d

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ShelfWatch / ParallelDots
+
+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,137 @@
+# ShelfWatch Ruby SDK
+
+Official Ruby client for [ShelfWatch APIs v2](https://api.shelfwatch.io).
+
+```bash
+gem install shelfwatch
+```
+
+Requires Ruby 2.6 or newer.
+
+## Quick start
+
+Create credentials in ShelfWatch Console → **Integrations**, then:
+
+```ruby
+require "shelfwatch"
+
+client = ShelfWatch.new(
+  api_key: "swpk_…",
+  project_id: "PROJECT_UUID",
+)
+
+visits = client.visits.list(
+  start_date: "2026-07-01",
+  end_date: "2026-07-31",
+)
+puts visits["data"]
+
+detail = client.visits.get(
+  visits["data"][0]["visit_uuid"],
+  include_kpis: true,
+)
+```
+
+### OAuth client credentials
+
+```ruby
+client = ShelfWatch.new(
+  client_id: "swoc_…",
+  client_secret: "swocs_…",
+  project_id: "PROJECT_UUID",
+)
+# Access tokens are fetched and refreshed automatically.
+```
+
+## API coverage
+
+| Resource | Methods |
+|----------|---------|
+| `client.visits` | `list`, `get` |
+| `client.mdm` | `stores`, `users`, `categories`, `brands`, `skus`, `schedules` |
+| `client.reports` | `list`, `generate` |
+
+Filters that accept multiple values can be passed as a comma-separated string or an array:
+
+```ruby
+client.visits.list(
+  start_date: "2026-07-01",
+  end_date: "2026-07-31",
+  visit_status: ["completed"],
+  store_code: ["S001", "S002"],
+)
+
+stores = client.mdm.stores(q: "delhi")
+reports = client.reports.list
+rows = client.reports.generate(
+  "visit-level",
+  start_date: "2026-07-01",
+  end_date: "2026-07-07",
+)
+```
+
+Full HTTP reference: ShelfWatch Console → **Help and Support**, or the [apis-v2 docs](https://github.com/ParallelDots/apis-v2).
+
+## Errors
+
+Typed exceptions map to HTTP status codes:
+
+| Exception | Status |
+|-----------|--------|
+| `ShelfWatch::ValidationError` | 400 |
+| `ShelfWatch::AuthenticationError` | 401 |
+| `ShelfWatch::ForbiddenError` | 403 |
+| `ShelfWatch::NotFoundError` | 404 |
+| `ShelfWatch::RateLimitError` | 429 |
+| `ShelfWatch::ServerError` | 5xx |
+| `ShelfWatch::Error` | other |
+
+```ruby
+require "shelfwatch"
+
+begin
+  client.visits.get("missing-uuid")
+rescue ShelfWatch::NotFoundError => e
+  puts "#{e.status_code} #{e.message}"
+end
+```
+
+## Development
+
+```bash
+bundle install
+bundle exec rake test
+```
+
+## Publish to RubyGems
+
+Create an API key at [rubygems.org/profile/api_keys](https://rubygems.org/profile/api_keys) with the **Push rubygem** scope (see [API key scopes](https://guides.rubygems.org/api-key-scopes/)). Then either:
+
+```bash
+# credentials file (~/.gem/credentials or ~/.local/share/gem/credentials)
+mkdir -p ~/.gem
+chmod 0700 ~/.gem
+printf -- "---\n:rubygems_api_key: rubygems_YOUR_KEY\n" > ~/.gem/credentials
+chmod 0600 ~/.gem/credentials
+```
+
+or set `GEM_HOST_API_KEY` for a one-off push:
+
+```bash
+export GEM_HOST_API_KEY=rubygems_YOUR_KEY
+```
+
+Publish:
+
+```bash
+./scripts/publish.sh
+```
+
+Or manually:
+
+```bash
+gem build shelfwatch.gemspec
+gem push shelfwatch-*.gem
+```
+
+Bump `VERSION` in `lib/shelfwatch/version.rb` (User-Agent follows automatically) before each release.

data/lib/shelfwatch/client.rb

@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "json"
+require "uri"
+
+module ShelfWatch
+  # Synchronous client for ShelfWatch APIs v2.
+  #
+  # Authenticate with either an API key or OAuth client credentials.
+  # Credentials are project-scoped (create them in Console → Integrations).
+  #
+  # Example (API key):
+  #
+  #     client = ShelfWatch::Client.new(
+  #       api_key: "swpk_…",
+  #       project_id: "PROJECT_UUID",
+  #     )
+  #     visits = client.visits.list(
+  #       start_date: "2026-07-01",
+  #       end_date: "2026-07-31",
+  #     )
+  #
+  # Example (OAuth):
+  #
+  #     client = ShelfWatch::Client.new(
+  #       client_id: "swoc_…",
+  #       client_secret: "swocs_…",
+  #       project_id: "PROJECT_UUID",
+  #     )
+  class Client
+    DEFAULT_BASE_URL = "https://api.shelfwatch.io"
+    DEFAULT_TIMEOUT = 60.0
+    # Refresh OAuth tokens this many seconds before expires_in.
+    TOKEN_SKEW_SECONDS = 60
+
+    attr_reader :project_id, :base_url, :visits, :mdm, :reports
+
+    def initialize(
+      api_key: nil,
+      client_id: nil,
+      client_secret: nil,
+      project_id: nil,
+      base_url: DEFAULT_BASE_URL,
+      timeout: DEFAULT_TIMEOUT,
+      connection: nil
+    )
+      has_key = !api_key.nil? && api_key != ""
+      has_oauth = (!client_id.nil? && client_id != "") ||
+                  (!client_secret.nil? && client_secret != "")
+
+      if has_key && has_oauth
+        raise ValidationError, "Provide either api_key or client_id/client_secret, not both"
+      end
+      if has_oauth && (client_id.nil? || client_id == "" || client_secret.nil? || client_secret == "")
+        raise ValidationError, "Both client_id and client_secret are required"
+      end
+      unless has_key || has_oauth
+        raise ValidationError, "Provide api_key or client_id and client_secret"
+      end
+
+      @project_id = project_id
+      @base_url = base_url.to_s.sub(%r{/+\z}, "")
+      @api_key = has_key ? api_key : nil
+      @client_id = has_oauth ? client_id : nil
+      @client_secret = has_oauth ? client_secret : nil
+      @access_token = nil
+      @token_expires_at = 0.0
+
+      @connection = connection || Faraday.new(url: @base_url) do |f|
+        f.options.timeout = timeout
+        f.options.open_timeout = timeout
+        f.headers["Accept"] = "application/json"
+        f.headers["User-Agent"] = "shelfwatch-ruby/#{VERSION}"
+        f.adapter Faraday.default_adapter
+      end
+
+      @visits = Resources::Visits.new(self)
+      @mdm = Resources::Mdm.new(self)
+      @reports = Resources::Reports.new(self)
+
+      return unless block_given?
+
+      begin
+        yield self
+      ensure
+        close
+      end
+    end
+
+    # Resolve project_id from the call or the client default.
+    def project(project_id = nil)
+      value = project_id || @project_id
+      if value.nil? || value == ""
+        raise ValidationError,
+              "project_id is required (pass it to ShelfWatch::Client.new(...) or to this method)"
+      end
+      value
+    end
+
+    # Send an authenticated request and return the JSON body.
+    def request(method, path, params: nil, data: nil, json: nil)
+      token = ensure_token
+      response = @connection.run_request(method.downcase.to_sym, path, nil, {}) do |req|
+        req.headers["Authorization"] = "Bearer #{token}"
+        req.params.update(stringify_keys(params)) if params
+        if data
+          req.headers["Content-Type"] = "application/x-www-form-urlencoded"
+          req.body = URI.encode_www_form(stringify_keys(data))
+        elsif !json.nil?
+          req.headers["Content-Type"] = "application/json"
+          req.body = JSON.generate(json)
+        end
+      end
+
+      Http.raise_for_status(response.status, response.body, response.reason_phrase)
+
+      return {} if response.status == 204 || response.body.nil? || response.body.empty?
+
+      begin
+        payload = JSON.parse(response.body)
+      rescue JSON::ParserError
+        return { "data" => response.body }
+      end
+      return { "data" => payload } unless payload.is_a?(Hash)
+
+      payload
+    end
+
+    # Call GET /health (no auth).
+    def health
+      response = @connection.get("/health")
+      Http.raise_for_status(response.status, response.body, response.reason_phrase)
+      payload = JSON.parse(response.body)
+      return { "data" => payload } unless payload.is_a?(Hash)
+
+      payload
+    end
+
+    # Expose the underlying Faraday connection (useful for tests).
+    def connection
+      @connection
+    end
+
+    # Close the underlying HTTP connection.
+    def close
+      @connection.close if @connection.respond_to?(:close)
+    end
+
+    private
+
+    def stringify_keys(hash)
+      hash.each_with_object({}) do |(key, value), out|
+        out[key.to_s] = value
+      end
+    end
+
+    def ensure_token
+      return @api_key if @api_key
+
+      now = Time.now.to_f
+      if @access_token && now < (@token_expires_at - TOKEN_SKEW_SECONDS)
+        return @access_token
+      end
+
+      response = @connection.post("/v2/oauth/token") do |req|
+        req.headers["Content-Type"] = "application/x-www-form-urlencoded"
+        req.body = URI.encode_www_form(
+          "grant_type" => "client_credentials",
+          "client_id" => @client_id,
+          "client_secret" => @client_secret
+        )
+      end
+      Http.raise_for_status(response.status, response.body, response.reason_phrase)
+
+      payload = begin
+        JSON.parse(response.body)
+      rescue JSON::ParserError
+        {}
+      end
+
+      token = payload.is_a?(Hash) ? payload["access_token"] : nil
+      if token.nil? || token == ""
+        raise AuthenticationError.new(
+          "OAuth token response missing access_token",
+          status_code: response.status,
+          body: payload
+        )
+      end
+
+      expires_in = (payload.is_a?(Hash) ? (payload["expires_in"] || 3600) : 3600).to_i
+      @access_token = token
+      @token_expires_at = now + expires_in
+      token
+    end
+  end
+end

data/lib/shelfwatch/errors.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module ShelfWatch
+  # Base exception for all ShelfWatch SDK errors.
+  class Error < StandardError
+    attr_reader :message, :status_code, :body
+
+    def initialize(message, status_code: nil, body: nil)
+      @message = message
+      @status_code = status_code
+      @body = body
+      super(to_s)
+    end
+
+    def to_s
+      if status_code
+        "[#{status_code}] #{message}"
+      else
+        message.to_s
+      end
+    end
+  end
+
+  # Raised on 401 responses (missing/invalid credential or token).
+  class AuthenticationError < Error; end
+
+  # Raised on 403 responses (wrong project or missing scope).
+  class ForbiddenError < Error; end
+
+  # Raised on 404 responses.
+  class NotFoundError < Error; end
+
+  # Raised on 400 responses (invalid parameters) and client-side validation.
+  class ValidationError < Error; end
+
+  # Raised on 429 responses.
+  class RateLimitError < Error; end
+
+  # Raised on 5xx responses.
+  class ServerError < Error; end
+end

data/lib/shelfwatch/http.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require "date"
+require "json"
+
+module ShelfWatch
+  # HTTP helpers and response handling.
+  module Http
+    module_function
+
+    # Map HTTP errors to typed SDK exceptions.
+    def raise_for_status(status, body, reason_phrase = nil)
+      return if status >= 200 && status < 300
+
+      parsed = decode_body(body)
+      fallback = (reason_phrase && !reason_phrase.empty?) ? reason_phrase : "Request failed"
+      message = detail_message(parsed, fallback)
+
+      case status
+      when 400 then raise ValidationError.new(message, status_code: status, body: parsed)
+      when 401 then raise AuthenticationError.new(message, status_code: status, body: parsed)
+      when 403 then raise ForbiddenError.new(message, status_code: status, body: parsed)
+      when 404 then raise NotFoundError.new(message, status_code: status, body: parsed)
+      when 429 then raise RateLimitError.new(message, status_code: status, body: parsed)
+      else
+        if status >= 500
+          raise ServerError.new(message, status_code: status, body: parsed)
+        end
+        raise Error.new(message, status_code: status, body: parsed)
+      end
+    end
+
+    # Omit nil query params so the API receives only set values.
+    # Booleans are serialized as "true" / "false" strings.
+    def drop_none(params)
+      out = {}
+      params.each do |key, value|
+        next if value.nil?
+
+        out[key] = if value == true || value == false
+                     value ? "true" : "false"
+                   else
+                     value
+                   end
+      end
+      out
+    end
+
+    # Accept a string or sequence and serialize as comma-separated.
+    def join_csv(value)
+      return nil if value.nil?
+      return value if value.is_a?(String)
+      return value.map(&:to_s).join(",") if value.is_a?(Array)
+
+      value.to_s
+    end
+
+    # Format a date-like value for visit/schedule endpoints.
+    # Strings pass through. Time/Date/DateTime → ISO-8601.
+    def format_date(value)
+      case value
+      when String
+        value
+      when Time
+        value.iso8601
+      when DateTime
+        value.iso8601
+      when Date
+        value.iso8601
+      else
+        value.to_s
+      end
+    end
+
+    # Format a calendar day as YYYY-MM-DD for report endpoints.
+    def format_day(value)
+      case value
+      when String
+        value
+      when Time
+        value.to_date.iso8601
+      when DateTime
+        value.to_date.iso8601
+      when Date
+        value.iso8601
+      else
+        value.to_s
+      end
+    end
+
+    def decode_body(raw)
+      return nil if raw.nil? || raw == ""
+
+      JSON.parse(raw)
+    rescue JSON::ParserError
+      raw
+    end
+
+    def detail_message(body, fallback)
+      if body.is_a?(Hash)
+        detail = body["detail"]
+        if detail.is_a?(String) && !detail.empty?
+          return detail
+        end
+        if detail.is_a?(Array) && !detail.empty?
+          parts = detail.map do |item|
+            if item.is_a?(Hash)
+              msg = item["msg"] || item["message"]
+              msg ? msg.to_s : nil
+            else
+              item.to_s
+            end
+          end.compact
+          return parts.join("; ") unless parts.empty?
+        end
+        message = body["message"]
+        return message if message.is_a?(String) && !message.empty?
+      end
+      return body if body.is_a?(String) && !body.empty?
+
+      fallback
+    end
+  end
+end

data/lib/shelfwatch/resources/mdm.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+module ShelfWatch
+  module Resources
+    # Master data management endpoints.
+    class Mdm
+      def initialize(client)
+        @client = client
+      end
+
+      # List stores for the project.
+      def stores(
+        project_id: nil,
+        limit: 100,
+        offset: 0,
+        store_code: nil,
+        q: nil,
+        include_total: true
+      )
+        @client.request(
+          "GET",
+          "/v2/mdm/stores",
+          params: Http.drop_none(
+            project_id: @client.project(project_id),
+            limit: limit,
+            offset: offset,
+            store_code: Http.join_csv(store_code),
+            q: q,
+            include_total: include_total
+          )
+        )
+      end
+
+      # List users for the project.
+      def users(
+        project_id: nil,
+        limit: 100,
+        offset: 0,
+        user_uuid: nil,
+        q: nil,
+        include_total: true
+      )
+        @client.request(
+          "GET",
+          "/v2/mdm/users",
+          params: Http.drop_none(
+            project_id: @client.project(project_id),
+            limit: limit,
+            offset: offset,
+            user_uuid: Http.join_csv(user_uuid),
+            q: q,
+            include_total: include_total
+          )
+        )
+      end
+
+      # List MDM categories for the project.
+      def categories(
+        project_id: nil,
+        limit: 100,
+        offset: 0,
+        q: nil,
+        include_inactive: false,
+        include_total: true
+      )
+        @client.request(
+          "GET",
+          "/v2/mdm/categories",
+          params: Http.drop_none(
+            project_id: @client.project(project_id),
+            limit: limit,
+            offset: offset,
+            q: q,
+            include_inactive: include_inactive,
+            include_total: include_total
+          )
+        )
+      end
+
+      # List MDM brands for the project.
+      def brands(
+        project_id: nil,
+        limit: 100,
+        offset: 0,
+        mdm_category_id: nil,
+        brand_id: nil,
+        q: nil,
+        include_inactive: false,
+        include_total: true
+      )
+        @client.request(
+          "GET",
+          "/v2/mdm/brands",
+          params: Http.drop_none(
+            project_id: @client.project(project_id),
+            limit: limit,
+            offset: offset,
+            mdm_category_id: Http.join_csv(mdm_category_id),
+            brand_id: Http.join_csv(brand_id),
+            q: q,
+            include_inactive: include_inactive,
+            include_total: include_total
+          )
+        )
+      end
+
+      # List MDM SKUs for the project.
+      def skus(
+        project_id: nil,
+        limit: 100,
+        offset: 0,
+        mdm_category_id: nil,
+        brand_id: nil,
+        sku_id: nil,
+        q: nil,
+        include_inactive: false,
+        include_total: true
+      )
+        @client.request(
+          "GET",
+          "/v2/mdm/skus",
+          params: Http.drop_none(
+            project_id: @client.project(project_id),
+            limit: limit,
+            offset: offset,
+            mdm_category_id: Http.join_csv(mdm_category_id),
+            brand_id: Http.join_csv(brand_id),
+            sku_id: Http.join_csv(sku_id),
+            q: q,
+            include_inactive: include_inactive,
+            include_total: include_total
+          )
+        )
+      end
+
+      # List schedules (max 31-day range on start_datetime).
+      def schedules(
+        start_date:,
+        end_date:,
+        project_id: nil,
+        limit: 100,
+        offset: 0,
+        store_code: nil,
+        user_uuid: nil,
+        frequency: nil,
+        include_total: true
+      )
+        @client.request(
+          "GET",
+          "/v2/mdm/schedules",
+          params: Http.drop_none(
+            project_id: @client.project(project_id),
+            start_date: Http.format_date(start_date),
+            end_date: Http.format_date(end_date),
+            limit: limit,
+            offset: offset,
+            store_code: Http.join_csv(store_code),
+            user_uuid: Http.join_csv(user_uuid),
+            frequency: frequency,
+            include_total: include_total
+          )
+        )
+      end
+    end
+  end
+end

data/lib/shelfwatch/resources/reports.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module ShelfWatch
+  module Resources
+    # Report list and generate endpoints.
+    class Reports
+      def initialize(client)
+        @client = client
+      end
+
+      # List available reports for the project.
+      def list(project_id: nil)
+        @client.request(
+          "GET",
+          "/v2/reports",
+          params: Http.drop_none(project_id: @client.project(project_id))
+        )
+      end
+
+      # Generate a report by report_id (see #list).
+      def generate(report_id, start_date:, end_date:, project_id: nil)
+        @client.request(
+          "GET",
+          "/v2/reports/generate",
+          params: Http.drop_none(
+            project_id: @client.project(project_id),
+            report_id: report_id,
+            start_date: Http.format_day(start_date),
+            end_date: Http.format_day(end_date)
+          )
+        )
+      end
+    end
+  end
+end

data/lib/shelfwatch/resources/visits.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module ShelfWatch
+  module Resources
+    # Visit list and detail endpoints.
+    class Visits
+      def initialize(client)
+        @client = client
+      end
+
+      # List visits for a project (max 31-day range).
+      def list(
+        start_date:,
+        end_date:,
+        project_id: nil,
+        limit: 100,
+        offset: 0,
+        user_uuid: nil,
+        store_code: nil,
+        visit_status: nil,
+        has_images: nil,
+        has_survey: nil,
+        include_total: true
+      )
+        @client.request(
+          "GET",
+          "/v2/visits",
+          params: Http.drop_none(
+            project_id: @client.project(project_id),
+            start_date: Http.format_date(start_date),
+            end_date: Http.format_date(end_date),
+            limit: limit,
+            offset: offset,
+            user_uuid: Http.join_csv(user_uuid),
+            store_code: Http.join_csv(store_code),
+            visit_status: Http.join_csv(visit_status),
+            has_images: has_images,
+            has_survey: has_survey,
+            include_total: include_total
+          )
+        )
+      end
+
+      # Get visit details (images, survey; optionally KPIs or a template).
+      def get(
+        visit_uuid,
+        project_id: nil,
+        include_kpis: false,
+        kpi_level: "topline",
+        template_id: nil,
+        category: nil
+      )
+        @client.request(
+          "GET",
+          "/v2/visits/#{visit_uuid}",
+          params: Http.drop_none(
+            project_id: @client.project(project_id),
+            include_kpis: include_kpis,
+            kpi_level: kpi_level,
+            template_id: template_id,
+            category: category
+          )
+        )
+      end
+    end
+  end
+end

data/lib/shelfwatch/version.rb

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

data/lib/shelfwatch.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "date"
+require "shelfwatch/version"
+require "shelfwatch/errors"
+require "shelfwatch/http"
+require "shelfwatch/resources/visits"
+require "shelfwatch/resources/mdm"
+require "shelfwatch/resources/reports"
+require "shelfwatch/client"
+
+# Official Ruby SDK for ShelfWatch APIs v2.
+#
+#   client = ShelfWatch.new(api_key: "swpk_…", project_id: "PROJECT_UUID")
+#   visits = client.visits.list(start_date: "2026-07-01", end_date: "2026-07-31")
+#
+module ShelfWatch
+  # Construct a {Client} (mirrors the Python ``ShelfWatch(...)`` entrypoint).
+  def self.new(**kwargs)
+    Client.new(**kwargs)
+  end
+end

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: shelfwatch
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- ShelfWatch / ParallelDots
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-08-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.10'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.10'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.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: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+description: Synchronous Ruby SDK for ShelfWatch visits, MDM, and reports APIs.
+email:
+- support@shelfwatch.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/shelfwatch.rb
+- lib/shelfwatch/client.rb
+- lib/shelfwatch/errors.rb
+- lib/shelfwatch/http.rb
+- lib/shelfwatch/resources/mdm.rb
+- lib/shelfwatch/resources/reports.rb
+- lib/shelfwatch/resources/visits.rb
+- lib/shelfwatch/version.rb
+homepage: https://github.com/ParallelDots/apis-ruby-sdk
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://shelfwatch.io
+  source_code_uri: https://github.com/ParallelDots/apis-ruby-sdk
+  documentation_uri: https://api.shelfwatch.io
+  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: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Official Ruby client for ShelfWatch APIs v2
+test_files: []