samcart_api 0.1.2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06fe1b45c2e3f892bd12685da744ad03e5f2b347714c2f5b0f142aaf6cd16a8d
-  data.tar.gz: 922fbf5b295f2edbb889128f2a68108c9093516deafd711677d6524be34c966e
+  metadata.gz: 3b46630dcf4afb835065d0ac482989a60d029a88573138006787dbf1b1fa4fc2
+  data.tar.gz: 7104d2969a0f4e98263f6d84ee2e3d6f8b1208add3d45ce3d1a103ba4b0415cb
 SHA512:
-  metadata.gz: '08ee150d36a9cf379a8f76e96ea40e087ff83e27d8946ff069fc3cc18f3f9bec64fe43b7f514e94334ee36ad248ffba1d22892c8e97ef9de2b2a613af651e524'
-  data.tar.gz: e2d035a48f85abb24d477881761334ca9cd8a277eacf334e1125d1596076ceea0d87e8cb1885f680fa3ac86a5c1be4ce5267395851861167b94cfcfa5a66b5ad
+  metadata.gz: d360a67d1037e3585ed0b26c4e41c890dc04cff07c98937efd60207bf847be9d087ab346cafd149013889af001f4e02e6a08c41947d1c450e9f7af7ebc77641c
+  data.tar.gz: 7d5b39108e8d9dbde7fb0d782342ea468196d432a9836f618b3dd0963635f2809c64cf30d0dc4c9a3ae21fa47d0545ae02b51d47494ce029d29b72ba68d7d242

data/lib/samcart_api/api_request.rb

@@ -1,16 +1,24 @@
 # frozen_string_literal: true
 
-module SamcartApi
+module SamcartAPI
   class ApiRequest
+    RETRY_ATTEMPTS = 3
+
     def initialize(method, path, params, api_key)
       @method = method
       @path = path
       @params = params
       @api_key = api_key
-      @version = SamcartApi.configuration.version
+      @version = SamcartAPI.configuration.version
     end
 
     def perform
+      safe_request { make_request }
+    end
+
+    private
+
+    def make_request
       response = connection.send(@method) do |req|
         req.url "/#{@version}#{@path}"
         req.params = @params if @params
@@ -22,10 +30,33 @@ module SamcartApi
       handle_response(response)
     end
 
-    private
+    def safe_request
+      retries = 0
+
+      begin
+        yield
+      rescue Faraday::TimeoutError, Faraday::ConnectionFailed => e
+        puts "Network error: #{e.message}. Retrying..."
+        sleep 2
+        retries += 1
+        retry if retries < RETRY_ATTEMPTS
+        raise 'Too many retries: Network issues'
+      rescue ApiError => e
+        if e.message.include?('Too Many Requests') # Custom handling for 429
+          wait_time = 5 # Default wait
+          puts "Rate limited! Retrying in #{wait_time} seconds..."
+          sleep wait_time
+          retries += 1
+          retry if retries < RETRY_ATTEMPTS
+          raise 'Too many retries: Rate limited'
+        else
+          raise
+        end
+      end
+    end
 
     def connection
-      @connection ||= Faraday.new(url: SamcartApi.configuration.api_url) do |conn|
+      @connection ||= Faraday.new(url: SamcartAPI.configuration.api_url) do |conn|
         conn.response :json
         conn.adapter Faraday.default_adapter
       end
@@ -41,6 +72,8 @@ module SamcartApi
         raise AuthenticationError, 'Access denied'
       when 404
         raise ApiError, 'Resource not found'
+      when 429
+        raise ApiError, 'Too Many Requests'
       else
         raise ApiError, "API request failed: #{response.body["message"] || response.body}"
       end

data/lib/samcart_api/client.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-module SamcartApi
+module SamcartAPI
   # Client for interacting with the SamCart API
   class Client
     def initialize(api_key = nil)
-      @api_key = api_key || SamcartApi.configuration.api_key
+      @api_key = api_key || SamcartAPI.configuration.api_key
       raise ConfigurationError, 'API key is required' unless @api_key
     end
 

data/lib/samcart_api/order.rb

@@ -1,30 +1,27 @@
 # frozen_string_literal: true
 
-module SamcartApi
+module SamcartAPI
   class Order
     RESOURCE_PATH = '/orders'
 
     class << self
       def find(id)
-        new(id).find
+        order = client.get("#{RESOURCE_PATH}/#{id}")
+        SamcartAPI::SamcartObject.new(order)
       end
-    end
-
-    def initialize(id)
-      @id = id
-    end
-
-    def find
-      order = client.get("#{RESOURCE_PATH}/#{id}")
-      SamcartApi::SamcartObject.new(order)
-    end
 
-    private
+      def client
+        SamcartAPI::Client.new
+      end
 
-    attr_reader :id
+      def all(filters: {}, limit: 100)
+        params = filters.merge(limit:)
+        SamcartAPI::Paginator.new(client, RESOURCE_PATH, params)
+      end
 
-    def client
-      @client ||= SamcartApi::Client.new
+      def charges(order_id)
+        client.get("#{RESOURCE_PATH}/#{order_id}/charges")
+      end
     end
   end
 end

data/lib/samcart_api/paginator.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module SamcartAPI
+  class Paginator
+    def initialize(client, path, params)
+      @client = client
+      @next_url = "#{path}?#{params.to_query}"
+      @retry_attempts = 3
+    end
+
+    def next_page?
+      !@next_url.nil?
+    end
+
+    def next_page
+      return unless next_page?
+
+      response = client.get(@next_url)
+      @next_url = response.dig('pagination', 'next')
+      response['data']
+    end
+
+    def each_page
+      yield next_page while next_page?
+    end
+
+    attr_reader :client
+  end
+end

data/lib/samcart_api/product.rb

@@ -1,30 +1,24 @@
 # frozen_string_literal: true
 
-module SamcartApi
+module SamcartAPI
   class Product
     RESOURCE_PATH = '/products'
 
     class << self
       def find(id)
-        new(id).find
+        product = client.get("#{RESOURCE_PATH}/#{id}")
+        SamcartAPI::SamcartObject.new(product)
       end
-    end
-
-    def initialize(id)
-      @id = id
-    end
 
-    def find
-      product = client.get("#{RESOURCE_PATH}/#{id}")
-      SamcartApi::SamcartObject.new(product)
-    end
-
-    private
+      def client
+        SamcartAPI::Client.new
+      end
 
-    attr_reader :id
+      def all(filters: {}, limit: 100)
+        params = filters.merge(limit:)
 
-    def client
-      @client ||= SamcartApi::Client.new
+        SamcartAPI::Paginator.new(client, RESOURCE_PATH, params)
+      end
     end
   end
 end

data/lib/samcart_api/samcart_object.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module SamcartApi
+module SamcartAPI
   class SamcartObject
     def initialize(attributes = {})
       @attributes = attributes
@@ -12,6 +12,9 @@ module SamcartApi
 
     def method_missing(method_name, *args)
       if @attributes.key?(method_name.to_s)
+
+        warn '[DEPRECATION] Dot notation (.) is deprecated and ' \
+          "will be removed in the next major version. Use hash access ['#{method_name}'] instead."
         @attributes[method_name.to_s]
       else
         super

data/lib/samcart_api/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SamcartAPI
+  VERSION = '1.0.0'
+end

data/lib/samcart_api.rb

@@ -5,7 +5,7 @@ require 'json'
 require 'active_support'
 require 'active_support/core_ext'
 
-module SamcartApi
+module SamcartAPI
   VERSION = '0.1.0'
 
   class Error < StandardError; end
@@ -18,6 +18,7 @@ module SamcartApi
   autoload :Order, 'samcart_api/order'
   autoload :Client, 'samcart_api/client'
   autoload :ApiRequest, 'samcart_api/api_request'
+  autoload :Paginator, 'samcart_api/paginator'
 
   class << self
     def configure

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: samcart_api
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 1.0.0
 platform: ruby
 authors:
 - Olumuyiwa Osiname
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-08 00:00:00.000000000 Z
+date: 2025-04-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -120,8 +120,10 @@ files:
 - lib/samcart_api/api_request.rb
 - lib/samcart_api/client.rb
 - lib/samcart_api/order.rb
+- lib/samcart_api/paginator.rb
 - lib/samcart_api/product.rb
 - lib/samcart_api/samcart_object.rb
+- lib/samcart_api/version.rb
 homepage: https://github.com/oluosiname/samcart_api
 licenses:
 - MIT
@@ -137,7 +139,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -147,5 +149,5 @@ requirements: []
 rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
-summary: Ruby gem for interacting with the SamCart API
+summary: Ruby wrapper for the SamCart API
 test_files: []