mintsoft 0.1.10 → 0.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ccd627b64addcd5ce4600e1df832ee931f1e98ff686ab706760cfdbc02f654f
-  data.tar.gz: 130cc96ccd064f08341c96b6ede9f06b5f86278d6dd0f3d2cccb8cbc36fb4a57
+  metadata.gz: 193f53b2dad0b19c81c5eb571928dde974fd46fe02f096b6093a33119528b074
+  data.tar.gz: 6968738d3114be16799ffd322fcecf8d4500cc913c5b557fd01c8694bc9271d9
 SHA512:
-  metadata.gz: 3597d97e005cf9ff18df541a96d8a3dd3348847f54fbf111b3999cebd1c7d77aea4df83d7ccfd9f5942278c0960a7267eeb79dd26f9d3e4dbad6414b4fb42360
-  data.tar.gz: bb3384d9dc29b08531761d88107695d3b8a79591e23a2d00ef5fa8d06f58597559344cf1689a4b6c4561a647c40d15e3c86524adb7bc0b0ab5beecd970b46d83
+  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/version.rb

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

metadata

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