parseapi 1.0.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8229ca82d3288ebdae0032fc5d3d8865d12b241f1627b6ccf2409e568eb5501a
-  data.tar.gz: 70929f039ede8fa845145a3c3803c186d1a8dfb8dd2af4b45b6fcf058772cb1f
+  metadata.gz: 61e682a9a5ac02f4539b92a60a198c5df729c3fe1f217b7695c31dc659b2e671
+  data.tar.gz: 8e9c4698f7a11569e012738d5b38128c741daf614f64bfd22910559851010822
 SHA512:
-  metadata.gz: 0b22da2a9cec679abc8ed1a8a60dcd2365cdb2776c49c58089df907653fd6971198d317348f72d4a5b8cf8d0c7ae8c8f51db34516aa3817cfe99df4fe830b983
-  data.tar.gz: 79894060499900eb0a2210fd36b260b68bba1b837a537274efe81e4aa0cc1353a4f29e89b19429486242b71993b3eb014c6109bd64a5caf2b4b6a1f21fbda87f
+  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.0.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.
 
@@ -192,7 +192,7 @@ Choose enrichment for the question you need answered.
 |---|---|
 | IP | Richer IP fields included with a paid plan. No separate check meter. |
 | Domain | Registration dates, registrar, status and DNSSEC, included with a paid plan. Use `dns` for DNS records and `mx` for mail routing. |
-| Email | A metered deliverability check, using included email checks or enabled on-demand usage. |
+| Email | A metered mailbox check with deliverability, catch-all, status, reason and address hints, using included email checks or enabled on-demand usage. |
 | VAT | A metered registry check where supported, using included VAT checks or enabled on-demand usage. |
 | Phone, Time, Date, Currency, Language, Emoji, IBAN, Point | Optional detail in the same pooled request on every plan. |
 | Country, State, District, City, Postal | The place profile on paid plans, including demographic and tax facts where held. |
@@ -201,6 +201,10 @@ Choose enrichment for the question you need answered.
 | Weather | Specialist current measurements and the existing forecast, alert, air and history bag on paid plans. |
 | Carrier, HLR | Optional diagnostic detail within the same metered core unit, including Free allowance units. No second gate or additional check. |
 
+Email deep includes mailbox status and the reason for the result, plus a suggested first name, no-reply flag, plus-address tag and mail service. The suggested name is not a verified identity. Unavailable details are null.
+
+Reasons include `accepted`, `invalid_format`, `invalid_domain`, `no_mail_server`, `mailbox_not_found`, `mailbox_disabled`, `mailbox_full`, `catchall`, `disposable`, `temporary_failure`, `rejected` and `unconfirmed`.
+
 Carrier, caller, and HLR are separate metered operations. Choose them explicitly when you need their answers. Ordinary lookups retry twice by default. Metered checks use one attempt by default. Setting retries explicitly can repeat paid usage.
 
 Without `deep`, the response omits that key. When requested, it is an empty object if access is locked or the operation has no deep fields. Otherwise it contains the available fields. A missing or null field means unknown.
@@ -261,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.0.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.0.0
+  version: 1.3.0
 platform: ruby
 authors:
 - ParseAPI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-16 00:00:00.000000000 Z
+date: 2026-09-21 00:00:00.000000000 Z
 dependencies: []
 description:
 email: