shopsavvy-sdk 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d081fbf3392d235e65de90a26888509f78989317334920e88cebe4657befe37c
-  data.tar.gz: '028202a7c601c12b53db7854be620abee4f4e3e0479e0ed3f1c1fe2e9107eeac'
+  metadata.gz: d423e461903d6f1c9627b3b055a19e3e4ebc25a7145c6a0f6b117067fdf231a6
+  data.tar.gz: 939995fa50338ba615d54e71f87fa75d44023faf4ec2057c5fef93f5a638d403
 SHA512:
-  metadata.gz: c1b1f2fdf1636fb0fa5149dc95e235b90aa5557f3d42c35acf1aff2ebb6ba6f124172178a1b1f9c79ee296e45baf01b69df66f55c876720dbe0063d9c5cc9f2b
-  data.tar.gz: da90ddde8a0830d8548e08ccb4f95297940a1418aa7fb66529d46aab50c34f3847cfbe633bc53a99b71635b0e6cd5dcf87c08dbd2750cebbbac11ca686be2f80
+  metadata.gz: 16e15e94cdee0d79b3ee20d2ecdf1a86c61cde8c4e2652b3171008fd415be2246611f0478c2dedcde1ed3d78c0e38a859122bd2667f36cde864f6f549a331cbd
+  data.tar.gz: ab8c59540a85e4e412659c4c64dc81f1812f8b339bcfcc6b69211fa39a33cc3dbeded890a72c9717f60fc1d053ae51c12a746722e51fc428bd013ffb63e122c5

data/README.md

@@ -20,19 +20,6 @@ product = client.get_product_details('012345678901')
 puts "#{product.data.name} - Best price: $#{client.get_current_offers('012345678901').data.min_by(&:price).price}"
 ```
 
-## 📊 Feature Comparison
-
-| Feature | Free Tier | Pro | Enterprise |
-|---------|-----------|-----|-----------|
-| **API Calls/Month** | 1,000 | 100,000 | Unlimited |
-| **Product Details** | ✅ | ✅ | ✅ |
-| **Real-time Pricing** | ✅ | ✅ | ✅ |
-| **Price History** | 30 days | 1 year | 5+ years |
-| **Bulk Operations** | 10/batch | 100/batch | 1000/batch |
-| **Retailer Coverage** | 50+ | 500+ | 1000+ |
-| **Rate Limiting** | 60/hour | 1000/hour | Custom |
-| **Support** | Community | Email | Phone + Dedicated |
-
 ## 🚀 Installation & Setup
 
 ### Installation

data/lib/shopsavvy_data_api/client.rb

@@ -253,6 +253,54 @@ module ShopsavvyDataApi
       APIResponse.new(response, data_class: UsageInfo)
     end
 
+    # Browse current shopping deals
+    # @param sort [String] Sort algorithm: hot, new, top-hour, top-day, top-week
+    # @param limit [Integer] Results per page (1-100)
+    # @param offset [Integer] Pagination offset
+    # @param options [Hash] Additional filters (category, retailer, tag, min_price, max_price, grade)
+    # @return [Hash] Deals response with deals array and pagination
+    def get_deals(sort: "hot", limit: 25, offset: 0, **options)
+      params = { sort: sort, limit: limit, offset: offset }.merge(options).compact
+      make_request(:get, "deals", params: params)
+    end
+
+    # Get TLDR review for a product (pros, cons, scores)
+    # @param identifier [String] Product identifier (barcode, ASIN, URL, model number)
+    # @return [Hash] Review response with review data or null
+    def get_product_review(identifier)
+      make_request(:get, "products/reviews", params: { id: identifier })
+    end
+
+    # Look up multiple products at once (sync for <=20, async for >20)
+    # @param identifiers [Array<String>] Product identifiers (max 100)
+    # @param include [Array<String>] Optional extras: ["offers"], ["reviews"]
+    def batch_lookup(identifiers, include: nil)
+      body = { identifiers: identifiers }
+      body[:include] = include if include
+      make_request(:post, "products/batch", body: body)
+    end
+
+    # Poll for async batch job results
+    def get_batch_status(batch_id)
+      make_request(:get, "batch/#{batch_id}")
+    end
+
+    def create_webhook(url, events:)
+      make_request(:post, "webhooks", body: { url: url, events: events })
+    end
+
+    def list_webhooks
+      make_request(:get, "webhooks")
+    end
+
+    def test_webhook(webhook_id)
+      make_request(:post, "webhooks/#{webhook_id}/test")
+    end
+
+    def delete_webhook(webhook_id)
+      make_request(:delete, "webhooks/#{webhook_id}")
+    end
+
     private
 
     def build_connection

data/lib/shopsavvy_data_api/models.rb

@@ -46,7 +46,9 @@ module ShopsavvyDataApi
   # Product details from ShopSavvy API
   class ProductDetails
     attr_reader :title, :shopsavvy, :brand, :category, :images, :barcode,
-                :amazon, :model, :mpn, :color
+                :amazon, :model, :mpn, :color,
+                :title_short, :slug, :description, :categories, :attributes,
+                :rating, :score, :keywords, :identifiers
 
     def initialize(data)
       @title = data["title"]
@@ -59,6 +61,15 @@ module ShopsavvyDataApi
       @model = data["model"]
       @mpn = data["mpn"]
       @color = data["color"]
+      @title_short = data["title_short"]
+      @slug = data["slug"]
+      @description = data["description"]
+      @categories = data["categories"]
+      @attributes = data["attributes"]
+      @rating = data["rating"]
+      @score = data["score"]
+      @keywords = data["keywords"]
+      @identifiers = data["identifiers"]
     end
 
     # @deprecated Use `title` instead
@@ -470,4 +481,44 @@ module ShopsavvyDataApi
       }
     end
   end
+
+  # Deal with expert grading
+  class Deal
+    attr_reader :path, :title, :subtitle, :description, :emoji, :grade,
+                :pricing, :retailer, :product, :url, :image, :votes,
+                :comment_count, :tags, :expires_at, :created_at
+
+    def initialize(data)
+      @path = data["path"]
+      @title = data["title"]
+      @subtitle = data["subtitle"]
+      @description = data["description"]
+      @emoji = data["emoji"]
+      @grade = data["grade"]
+      @pricing = data["pricing"]
+      @retailer = data["retailer"]
+      @product = data["product"]
+      @url = data["url"]
+      @image = data["image"]
+      @votes = data["votes"]
+      @comment_count = data["comment_count"].to_i
+      @tags = data["tags"]
+      @expires_at = data["expires_at"]
+      @created_at = data["created_at"]
+    end
+  end
+
+  # TLDR product review
+  class TLDRReview
+    attr_reader :slug, :headline, :pros, :cons, :bottom_line, :scores
+
+    def initialize(data)
+      @slug = data["slug"]
+      @headline = data["headline"]
+      @pros = data["pros"] || []
+      @cons = data["cons"] || []
+      @bottom_line = data["bottom_line"]
+      @scores = data["scores"]
+    end
+  end
 end

data/lib/shopsavvy_data_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ShopsavvyDataApi
-  VERSION = "1.0.2"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: shopsavvy-sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - ShopSavvy by Monolith Technologies, Inc.
 bindir: exe
 cert_chain: []
-date: 2025-12-17 00:00:00.000000000 Z
+date: 2026-05-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday