parseapi 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eea5dc559df5f4a2007ef9aedf6a4347ca9090258401a3ffc1e55111dce93dbd
-  data.tar.gz: 9c4594ac80967acf22f4e1d8f7b98072eee25e9729f2979632cc2307eeed755a
+  metadata.gz: 61e682a9a5ac02f4539b92a60a198c5df729c3fe1f217b7695c31dc659b2e671
+  data.tar.gz: 8e9c4698f7a11569e012738d5b38128c741daf614f64bfd22910559851010822
 SHA512:
-  metadata.gz: 3a950380627ddd9a7d98f47fde1405801a404144c75b01c1b3b15c696cb3e57f82dedf330984de6e05aaef646d6c030f1e9b54ec838cf8a053c4b134f6c7cdb2
-  data.tar.gz: e3f27a65ea6b8aed25a7f6a77d99fee5bef2d682ee883102983a31f1a192181be90d68a4cb4f602f1a3e5a1889ea9c97ac85319f7dfa2f8614297fd11c73b08a
+  metadata.gz: f6fb0796e7f85b72285842ac69a8773911f098bf3c340d3ba7606bdb3c8162b54a97ed4533aa6ed595c64dd5486962b8851f60960d4598f2c02e473addf4129e
+  data.tar.gz: 28353915115ecfafe4a2128e8fd5c98283c0f28de71f279d60d9b7b2ecebae6dcfc0c7489846decde86461a84037975a1b229520ab2e0c2bf1582fd7ca3af60b

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.3.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.
 
@@ -265,3 +265,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.3.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.3.0
 platform: ruby
 authors:
 - ParseAPI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-20 00:00:00.000000000 Z
+date: 2026-09-21 00:00:00.000000000 Z
 dependencies: []
 description:
 email: