mintsoft 0.1.9 → 0.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b07eb48344fbc2e9350b4dfb180155f25849e2e07b6918089b577436b156ea3
-  data.tar.gz: a41f333869f6cee4e8e662aaf227fa10b4ae91221ccfb18df1140b42e7a09ff7
+  metadata.gz: 193f53b2dad0b19c81c5eb571928dde974fd46fe02f096b6093a33119528b074
+  data.tar.gz: 6968738d3114be16799ffd322fcecf8d4500cc913c5b557fd01c8694bc9271d9
 SHA512:
-  metadata.gz: 070433bc3da2e1357514c4aa98a0b7daea60e05403077beca76f9e7910cc1548d2ca6f71e7b8ee37db34a035def363ee793f9d27dab22a74e936bb93e2a1d842
-  data.tar.gz: 2e9a745d24b126e9bdf6a21b3bfddfe6fcc944683f323ed8c715b2a4c903cfd1be7b9dea7be2cfae954ca8d9b3a734d0efc4fbc66603f0208f0cd82772cc10ce
+  metadata.gz: 36a1196c64c41022aa01ff352fb4ae13e0d100937f864cd8cc2ad965439dea86c435f89e92fee2332e4725ed1f87bba64299b837fa188ec88e32e6823abafab5
+  data.tar.gz: bb75d0cca832ea9e1f5f9a017587dbb45d20685fdffc1656952abfca76954dba7ea55deb04b54a55c2e2dd3f256f1097df5e10f990a10e28b10f8af1f564a137

data/README.md

@@ -33,32 +33,44 @@ Or install it yourself as:
 ```ruby
 require 'mintsoft'
 
-# Step 1: Get authentication token
-auth_client = Mintsoft::AuthClient.new
-token = auth_client.auth.authenticate("username", "password")
-
-# Step 2: Initialize client with token
-client = Mintsoft::Client.new(token: token)
-
-# Step 3: Search for orders
-orders = client.orders.search("ORD-2024-001")
-order = orders.first
-
-# Step 4: Get return reasons
-reasons = client.returns.reasons
-damage_reason = reasons.find { |r| r.name.include?("Damaged") && r.active? }
-
-# Step 5: Create return
-return_obj = client.returns.create(order.id)
-
-# Step 6: Add item to return
-result = client.returns.add_item(return_obj.id, {
-  product_id: 123,
-  quantity: 2,
-  reason_id: damage_reason.id,
-  unit_value: 25.00,
-  notes: "Damaged in shipping"
-})
+begin
+  # Step 1: Get authentication token
+  auth_client = Mintsoft::AuthClient.new
+  token = auth_client.auth.authenticate("username", "password")
+
+  # Step 2: Initialize client with token
+  client = Mintsoft::Client.new(token: token)
+
+  # Step 3: Search for orders
+  orders = client.orders.search("ORD-2024-001")
+  if orders.empty?
+    puts "No orders found"
+    return
+  end
+  order = orders.first
+
+  # Step 4: Get return reasons
+  reasons = client.returns.reasons
+  damage_reason = reasons.find { |r| r.name.include?("Damaged") && r.active? }
+
+  # Step 5: Create return
+  return_obj = client.returns.create(order.id)
+
+  # Step 6: Add item to return
+  result = client.returns.add_item(return_obj.id, {
+    product_id: 123,
+    quantity: 2,
+    reason_id: damage_reason.id,
+    unit_value: 25.00,
+    notes: "Damaged in shipping"
+  })
+rescue Mintsoft::AuthClient::AuthenticationError => e
+  puts "Authentication failed: #{e.message}"
+rescue Mintsoft::AuthenticationError => e
+  puts "Token expired: #{e.message}"
+rescue Mintsoft::ValidationError => e
+  puts "Validation error: #{e.message}"
+end
 ```
 
 ### API Reference
@@ -70,8 +82,16 @@ result = client.returns.add_item(return_obj.id, {
 auth_client = Mintsoft::AuthClient.new
 
 # Authenticate and get token
-token = auth_client.auth.authenticate("username", "password")
-puts token  # Direct token string
+begin
+  token = auth_client.auth.authenticate("username", "password")
+  puts token  # Direct token string
+rescue Mintsoft::AuthClient::AuthenticationError => e
+  # Invalid credentials when getting auth token
+  puts "Auth failed: #{e.message}"
+rescue Mintsoft::ValidationError => e
+  # Missing username or password
+  puts "Validation error: #{e.message}"
+end
 ```
 
 #### Client
@@ -93,6 +113,9 @@ client = Mintsoft::Client.new(
 # Search for orders by order number
 orders = client.orders.search("ORD-123")
 
+# Retrieve specific order by ID
+order = client.orders.retrieve(order_id)
+
 # Access order properties
 order = orders.first
 puts order.id              # Direct access to order ID
@@ -140,16 +163,17 @@ All error classes now include response context and status codes for better debug
 begin
   orders = client.orders.search("ORD-123")
 rescue Mintsoft::AuthenticationError => e
-  # Token expired or invalid (401)
+  # Token expired or invalid (401) - for API resource calls
   puts "Authentication failed: #{e.message}"
   puts "Status: #{e.status_code}"
+rescue Mintsoft::AuthClient::AuthenticationError => e
+  # Invalid credentials when getting auth token
+  puts "Auth client authentication failed: #{e.message}"
+  puts "Status: #{e.status_code}"
 rescue Mintsoft::ValidationError => e
   # Invalid request data (400)
   puts "Validation error: #{e.message}"
   puts "Response: #{e.response.body if e.response}"
-rescue Mintsoft::NotFoundError => e
-  # Resource not found (404)
-  puts "Not found: #{e.message}"
 rescue Mintsoft::APIError => e
   # General API error
   puts "API error: #{e.message}"
@@ -157,6 +181,24 @@ rescue Mintsoft::APIError => e
 end
 ```
 
+### Not Found Behavior
+
+When resources cannot be found, the gem returns `nil` instead of raising exceptions:
+
+```ruby
+# Search for orders - returns empty array if no orders found
+orders = client.orders.search("NONEXISTENT-ORDER")
+puts orders.empty? # true
+
+# Retrieve specific order - returns nil if not found
+order = client.orders.retrieve(99999)
+puts order.nil? # true
+
+# Retrieve specific return - returns nil if not found
+return_obj = client.returns.retrieve(99999)
+puts return_obj.nil? # true
+```
+
 ### Object Methods
 
 #### Order Objects

data/lib/mintsoft/errors.rb

@@ -15,13 +15,9 @@ module Mintsoft
   # General API-related errors
   class APIError < Error; end
 
-
   # Authentication and authorization errors
   class AuthenticationError < APIError; end
 
-  # Resource not found errors
-  class NotFoundError < APIError; end
-
   # Request validation errors
   class ValidationError < APIError; end
 end

data/lib/mintsoft/resources/base_resource.rb

@@ -36,7 +36,6 @@ module Mintsoft
         error_class = case response.status
         when 400 then ValidationError
         when 401 then AuthenticationError
-        when 404 then NotFoundError
         else APIError
         end
 
@@ -50,8 +49,6 @@ module Mintsoft
           "Invalid or expired token"
         when 400
           "Invalid request data: #{error_message}"
-        when 404
-          "Resource not found"
         else
           "API error: #{status} - #{error_message}"
         end

data/lib/mintsoft/resources/returns.rb

@@ -35,9 +35,13 @@ module Mintsoft
         validate_return_id!(return_id)
 
         response = get_request("/api/Return/#{return_id}")
-        response_data = handle_response(response)
 
-        Objects::Return.new(response_data)
+        if response.status == 404
+          nil # Return nil for not found returns
+        else
+          response_data = handle_response(response)
+          Objects::Return.new(response_data)
+        end
       end
 
       private

data/lib/mintsoft/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mintsoft
-  VERSION = "0.1.9"
+  VERSION = "0.1.11"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mintsoft
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.1.11
 platform: ruby
 authors:
 - Andy Chong