parseapi 1.1.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eea5dc559df5f4a2007ef9aedf6a4347ca9090258401a3ffc1e55111dce93dbd
-  data.tar.gz: 9c4594ac80967acf22f4e1d8f7b98072eee25e9729f2979632cc2307eeed755a
+  metadata.gz: 4ff073cfaba8eb3f7afa9550ddc3e69aa9ac77c48ebc082393489eedc465139a
+  data.tar.gz: e09d1d59dde43a30422d4e2b5f1ce011fa30952bddbe570c95acc07b26ce366e
 SHA512:
-  metadata.gz: 3a950380627ddd9a7d98f47fde1405801a404144c75b01c1b3b15c696cb3e57f82dedf330984de6e05aaef646d6c030f1e9b54ec838cf8a053c4b134f6c7cdb2
-  data.tar.gz: e3f27a65ea6b8aed25a7f6a77d99fee5bef2d682ee883102983a31f1a192181be90d68a4cb4f602f1a3e5a1889ea9c97ac85319f7dfa2f8614297fd11c73b08a
+  metadata.gz: d36e99b464e96c9b6b9a33038f5aafad856606be7a394ee7d6df0b66afd1aa584ee0b7a45e116deb9fb281a3198fa063e1f652242ef6987cc353b427c00df9d5
+  data.tar.gz: 1e894cfdf2410f80eca23d6b7dae2b4652cf417a32737ea907ca9bd5243192b98f11ebb230aa10f448bce90b8eac6160fbbc13536fb571c4e04f3b7df78d105b

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.1.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.4.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.
 
@@ -153,6 +153,8 @@ Unit discovery accepts optional `query`, `type`, and `unit` filters. `unit` sele
 
 ## Place statistics and optional detail
 
+Australian postal lookups include core `localities` with suburb choices (`city`, `state`, `state_name`) on every plan. Null or an omitted field means unknown, while `[]` means the reviewed reference has no eligible choices. `city` stays null when the source is ambiguous, even if there is only one eligible choice. Let the user select their suburb and keep manual entry available. These are geographic choices, not mailing-address verification. [G-NAF source, adaptations and licence](https://parseapi.com/legal/attribution#postal-au).
+
 Postal and District paid profiles include `deep.property_tax` where supported. It contains `annual_median`, `currency` and `period`: median annual property tax payable on owner-occupied homes in the statistical area. The amount is adjusted to the final year of the reporting period (`YYYY-YYYY`). This is an area statistic, not a rate or an individual property bill. Unsupported, missing and censored estimates are null.
 
 ```ruby
@@ -265,3 +267,17 @@ basic = parse.time('America/New_York')
 detail = parse.time('America/New_York', deep: true)
 puts basic['at'], detail.dig('deep', 'next_dst')
 ```
+
+## Stack API
+
+```ruby
+result = parse.stack("example.com")
+```
+
+Pass a public hostname without a scheme, path, port or IP address. Stack returns the checked URL and `checked_at` time, followed by `scope`, `pages` and `partial`. `scope` is `homepage` or `site`; `pages` counts successfully checked HTML pages. `partial` is true for homepage-only or incomplete bounded site checks. False means the known in-scope candidates were completed, not that every page on a website was visited. A homepage result has `scope: "homepage"`, `pages: 1` and `partial: true`.
+
+`cms`, `servers`, `frameworks`, `ecommerce`, `analytics`, `chat`, `payments` and `hosting` are arrays because a site can use several technologies in each category. Each entry contains `technology`, `name` and nullable `version`. Technology codes are open strings. A successful check uses empty arrays for categories with no matches. When no HTML page could be checked, `checked_at` and all categories are null, `pages` is 0 and `partial` is null. Unknown or conflicting versions are null. Missing detections do not prove absence.
+
+Successful checks may be reused for up to 24 hours. `pretty` optionally formats the wire JSON. Stack uses your plan's request allowance and API version 2.0.0 selected by this client.
+
+Stack defaults to a 35-second transport timeout so a first scan has time to finish. Other lookups retain their 10-second default. An explicit client timeout takes precedence.

data/lib/parseapi/client.rb

@@ -38,6 +38,7 @@ module ParseAPI
 
 			@base_url = URI((base_url || ENV['PARSEAPI_BASE_URL'] || DEFAULT_BASE_URL).sub(%r{/+\z}, ''))
 			@timeout = timeout || DEFAULT_TIMEOUT
+			@timeout_explicit = !timeout.nil?
 			@retries = retries
 			raise ArgumentError, 'parseapi: timeout must be a finite positive number.' unless @timeout.is_a?(Numeric) && @timeout.finite? && @timeout > 0
 			raise ArgumentError, 'parseapi: retries must be a non-negative integer or nil.' unless @retries.nil? || (@retries.is_a?(Integer) && @retries >= 0)
@@ -205,6 +206,13 @@ module ParseAPI
 			get("/hlr/#{seg(number)}", country: country, deep: deep)
 		end
 
+		# Identify website technologies and versions by category.
+		# All categories are lists. Scope, pages and partial describe bounded coverage.
+		# Lists are nil when no page could be checked and empty for no matches.
+		def stack(domain, deep: false, pretty: false)
+			get("/stack/#{seg(domain)}", deep: deep, pretty: pretty)
+		end
+
 		# Check whether a domain is registered. Deep adds registration dates, registrar, status and DNSSEC on paid plans.
 		def domain(domain, deep: false)
 			get("/domain/#{seg(domain)}", deep: deep)
@@ -390,7 +398,8 @@ module ParseAPI
 		def execute(uri, headers)
 			return @transport.call(uri.to_s, headers) if @transport
 
-			http = connection
+			timeout = !@timeout_explicit && uri.path.start_with?('/stack/') ? 35 : @timeout
+			http = connection(timeout)
 			request = Net::HTTP::Get.new(uri.request_uri)
 			headers.each { |name, value| request[name] = value }
 			response = http.request(request)
@@ -399,17 +408,17 @@ module ParseAPI
 			[response.code.to_i, header_hash, response.body || '']
 		end
 
-		def connection
+		def connection(timeout = @timeout)
 			if @http.nil?
 				@http = Net::HTTP.new(@base_url.host, @base_url.port)
 				@http.use_ssl = @base_url.scheme == 'https'
-				@http.open_timeout = @timeout
-				@http.read_timeout = @timeout
-				@http.write_timeout = @timeout
 				# The client owns retries, including retries: 0.
 				@http.max_retries = 0
 				@http.keep_alive_timeout = 30
 			end
+			@http.open_timeout = timeout
+			@http.read_timeout = timeout
+			@http.write_timeout = timeout
 			@http.start unless @http.started?
 			@http
 		end

data/lib/parseapi/version.rb

@@ -1,3 +1,3 @@
 module ParseAPI
-	VERSION = '1.1.0'.freeze
+	VERSION = '1.4.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parseapi
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.4.0
 platform: ruby
 authors:
 - ParseAPI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-20 00:00:00.000000000 Z
+date: 2026-09-24 00:00:00.000000000 Z
 dependencies: []
 description:
 email: