parseapi 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73f1b424549c76d9c2b85d8571a47531254b144d53fc62e58e0637c2992e53e6
-  data.tar.gz: e421ec5da88ddec8b7dbbce5d1f43ecee0ba68a5fa6c8e6721fbc2b7678aa196
+  metadata.gz: c6598fb8f4a05494418599738f387ab8137099ddb12ac09f63ca42410d6b4b89
+  data.tar.gz: 9de6f2540a617508c1c9a298361db8218e5f0460fb4a03e1e2c04a85179badca
 SHA512:
-  metadata.gz: 25878269f2677245170b84be1d2b2ad0f19f923509daab15674e94bfa372bd6b2c64c946941a9560aa018fe41eb4e88987ff0d9e459baf7118f50a397e69c982
-  data.tar.gz: 2922d33c672fa469cddf839f8f06ad0081b44c16ef1c6313891fd3906b9c3a441f153324cf6723272cbb2003e715a80079a555bab0c9de311f85c3dd6291b375
+  metadata.gz: 2599c0832bed2f4306ac4f1b5eb31a2d4757546a7349178a8c7bd693605ee091b107cec97c2005d0ed002afa9e2758f0b22d86c679fd15efffad1bd6fa0453d4
+  data.tar.gz: 3d6a7f151089a85c0e76624f84cdd788df87a329371669505efd3179ec98c682017248e969072949f3975c70687ae4d9dfc766fec0949211df22a89374c80533

data/README.md

@@ -13,7 +13,7 @@ Get a key at [parseapi.com](https://parseapi.com). The client also reads `PARSEA
 
 ## API versions
 
-Version 1.6.0 explicitly selects the API contract supported by this SDK. It sends `Parse-Version: 2.0.0` on every lookup so responses match the API contract supported by the package. Your key and the team's saved default stay the same.
+Version 1.7.0 explicitly selects the API contract supported by this SDK. It sends `Parse-Version: 2.0.0` on every lookup so responses match the API contract supported by the package. Your key and the team's saved default stay the same.
 
 Upgrade the dependency in staging, review the [release notes](https://parseapi.com/docs/releases), and test the application before deploying the same code and dependency version to production. Commit your dependency lockfile so the tested package travels with your deployment. Future major SDK upgrades can select a newer API contract.
 
@@ -219,6 +219,12 @@ parse.weather(40.7128, -74.006, deep: true, date: '2026-08-15')
 
 Tariff starts with the general schedule line. Paid deep adds units and the special and other schedule columns. An optional origin then resolves country-specific measures. The three calls below show those successive choices. Without origin, schedule detail is still returned and origin-dependent fields are null. A null effective rate is not a zero rate.
 
+Tariff lookup and search accept an optional `edition` fingerprint and `date` (`YYYY-MM-DD`). The edition pins exact immutable source bytes. A date is accepted only when verified source coverage exists. An edition without a date returns undated schedule context (`date: null`). Default requests use today. Paid detail exposes an open-string `reason` when `effective_rate` is null, including `incomplete_coverage`. A null rate never means zero. Explicit selections fail with `tariff_selection_mismatch` if an older server ignores the requested scope.
+
+Origin means where the goods originate, not where they ship from. The effective rate covers matched stored schedule measures only. It is not complete duty or landed cost.
+
+Codes contain 4, 6, 8 or 10 ASCII digits; dots and whitespace are optional. Search returns up to 20 description matches with parent `lineage` so a result named "Other" has context. Search is not product classification. In deep, `measures: null` means origin-dependent measures were not resolved. `measures: []` means the resolved lookup found none.
+
 ```ruby
 parse.tariff('8471.30.01.00')
 parse.tariff('8471.30.01.00', deep: true)

data/lib/parseapi/client.rb

@@ -258,12 +258,12 @@ module ParseAPI
 		# schedule columns. Add origin with deep to resolve country-specific measures. Without origin,
 		# schedule detail remains available and origin-dependent fields are null. A null effective rate
 		# is not a zero rate.
-		def tariff(code, deep: false, origin: nil)
-			get("/tariff/#{seg(code)}", deep: deep, origin: origin)
+		def tariff(code, deep: false, origin: nil, edition: nil, date: nil)
+			tariff_selection(get("/tariff/#{seg(code)}", deep: deep, origin: origin, edition: edition, date: date), edition, date)
 		end
 
-		def tariff_search(query)
-			get('/tariff', q: query)
+		def tariff_search(query, edition: nil, date: nil)
+			tariff_selection(get('/tariff', q: query, edition: edition, date: date), edition, date)
 		end
 
 		def currency(code, deep: false, lang: nil)
@@ -381,6 +381,14 @@ module ParseAPI
 			targets.join(',')
 		end
 
+		def tariff_selection(result, edition, date)
+			if (!edition.nil? || !date.nil?) && (!result['edition'].is_a?(String) || !/\A[a-f0-9]{64}\z/.match?(result['edition']) || (!edition.nil? && result['edition'] != edition) || result['date'] != date)
+				raise Error.new(status: 0, code: 'tariff_selection_mismatch', message: 'Tariff response did not confirm the requested edition/date. The server may not support this selection.')
+			end
+			result
+		end
+
+
 		def seg(value)
 			URI.encode_www_form_component(value.to_s).gsub('+', '%20')
 		end

data/lib/parseapi/version.rb

@@ -1,3 +1,3 @@
 module ParseAPI
-	VERSION = '1.6.0'.freeze
+	VERSION = '1.7.0'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: parseapi
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - ParseAPI