znyx-sdk 1.2.1 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 816193b73770d4949028adf8359e4e402aa8cdd2fc9a2f39235ea9bc47acc946
-  data.tar.gz: 4cff940a92b4b7905422405a09a70e6f08864d08f318adb8e20c58e2ce5e3a8f
+  metadata.gz: 5fd9be653cf74c03cdf4c2bfa14b6b1b68d8e66f61e1b74fe2c728c171f08772
+  data.tar.gz: 96f53a1fe2ee7d1acd9366bc12a1622bddc734c1e1c63091230bfd31371360d6
 SHA512:
-  metadata.gz: 71e56c056f15328e7f7cb1a83177906755f6fbb8e5279700b593673f09a49b04ab7754a611fc5f660e47bde51975491f35155377270f51da190942f3286ea3ad
-  data.tar.gz: fb7938b04ed59c4b2b3d51c6245b25f1a0ca58b0b5329fff2096a96b732d2f31c76f48dee14cfa3f72958791114e7af6b5bbb709b30b519e3c40474429324d53
+  metadata.gz: 3be73e2f490347a9eb925da15e70cbb3b1fad9688c2c25b2fe37e42099803e24248d9288f400a99151b291f68c3eb227a63aa3ad320cecabac3d3a5596c4a157
+  data.tar.gz: 66b85bb0a0eb2d4d1adfa7ab4e077a0727818c82e39246bcf46b358f70282e21e4c55f4cd9ff1278223de9cacb509d0bc1ab3fdc224b527a99ab66e177c9a1c0

data/lib/znyx_sdk/client.rb

@@ -79,6 +79,15 @@ module ZnyxSdk
       }.merge(kwargs.compact)
     end
 
+    # Resolved defensively: `post` runs on the request hot path and
+    # znyx_sdk.rb defines VERSION *after* requiring this file, so a partial
+    # require (`require "znyx_sdk/client"` alone) would otherwise raise
+    # NameError mid-request. A missing version is metadata we can do without;
+    # a broken evaluation call is not.
+    def sdk_version
+      defined?(ZnyxSdk::VERSION) ? ZnyxSdk::VERSION : "unknown"
+    end
+
     def post(path, payload)
       http = Net::HTTP.new(@uri.host, @uri.port)
       http.use_ssl     = @uri.scheme == "https"
@@ -87,6 +96,16 @@ module ZnyxSdk
 
       request = Net::HTTP::Post.new(path)
       request["Content-Type"] = "application/json"
+      # X-Znyx-Sdk/-Version identify the calling SDK. The runtime records the
+      # newest pair it sees and forwards it to the control plane with its own
+      # heartbeat, which is what lets the console show an operator the SDK
+      # version their applications are actually running - anonymous install
+      # telemetry cannot answer that, as it carries no org.
+      #
+      # X-Znyx-Sdk reuses the telemetry `source` vocabulary ("ruby-sdk"), so the
+      # console and the admin install table label languages identically.
+      request["X-Znyx-Sdk"] = "ruby-sdk"
+      request["X-Znyx-Sdk-Version"] = sdk_version
       request["Authorization"] = "Bearer #{@api_key}" if @api_key
       request.body = JSON.generate(payload)
 
@@ -106,8 +125,9 @@ module ZnyxSdk
       raise ZnyxError, "HTTP request failed: #{e.message}"
     end
 
+    # 128-bit random id, same shape as the other SDKs.
     def new_request_id
-      "req_#{SecureRandom.hex(4)}"
+      SecureRandom.uuid
     end
   end
 end

data/lib/znyx_sdk/telemetry.rb

@@ -13,8 +13,10 @@ module ZnyxSdk
   #
   # Sends a single fire-and-forget ping when a client is first constructed, then
   # at most one "heartbeat" ping per 24h. Non-sensitive metadata only:
-  # install_id (random UUID, persisted to ~/.znyx/sdk-state.json), SDK version,
-  # source ("ruby-sdk"), OS / arch / Ruby version, run_count.
+  # install_id (random UUID, persisted to ~/.znyx/sdk-state-ruby.json), SDK
+  # version, source ("ruby-sdk"), OS / arch / Ruby version, run_count. The state
+  # file is per language, so this SDK's ping schedule is independent of any other
+  # ZNYX SDK installed on the same machine.
   #
   # No PII, no request content, no tenant data. Opt out with
   # ZNYX_TELEMETRY=false (on by default). Disclosed once to stderr on the first
@@ -25,13 +27,20 @@ module ZnyxSdk
     # install telemetry is on out of the box (opt-out, fully transparent).
     # Override with ZNYX_TELEMETRY_URL (or ZNYX_HEARTBEAT_URL), or opt out with
     # ZNYX_TELEMETRY=false.
-    ENDPOINT = (
-      (ENV["ZNYX_TELEMETRY_URL"] || "").empty? ? nil : ENV["ZNYX_TELEMETRY_URL"]
-    ) || (
-      (ENV["ZNYX_HEARTBEAT_URL"] || "").empty? ? nil : ENV["ZNYX_HEARTBEAT_URL"]
-    ) || "https://cp.znyx.ai/v1/install-telemetry"
-
-    STATE_FILE = File.join(Dir.home, ".znyx", "sdk-state.json")
+    #
+    # Defaults to the ZNYX receiver. An EMPTY value removes the destination, which is
+    # distinct from leaving it unset: with no destination nothing is sent even though this
+    # SDK is opt-out, giving an air-gapped deployment a verifiable guarantee. Hence the
+    # nil? checks rather than empty? — the latter would collapse "" back into the default.
+    ENDPOINT = if !ENV["ZNYX_TELEMETRY_URL"].nil?
+                 ENV["ZNYX_TELEMETRY_URL"].strip
+               elsif !ENV["ZNYX_HEARTBEAT_URL"].nil?
+                 ENV["ZNYX_HEARTBEAT_URL"].strip
+               else
+                 "https://cp.znyx.ai/v1/install-telemetry"
+               end
+
+    STATE_FILE = File.join(Dir.home, ".znyx", "sdk-state-ruby.json")
     HEARTBEAT_INTERVAL = 86_400 # seconds (24h)
     SOURCE = "ruby-sdk"
 
@@ -87,16 +96,18 @@ module ZnyxSdk
         end
 
         payload = {
-          install_id:   install_id,
-          version:      version,
-          event_type:   event_type,
-          source:       SOURCE,
-          os:           RbConfig::CONFIG["host_os"],
-          os_version:   host_os_version,
-          arch:         RbConfig::CONFIG["host_cpu"],
-          ruby_version: RUBY_VERSION,
-          run_count:    run_count,
-          timestamp:    now_iso
+          install_id:     install_id,
+          version:        version,
+          event_type:     event_type,
+          source:         SOURCE,
+          os:             RbConfig::CONFIG["host_os"],
+          os_version:     host_os_version,
+          arch:           RbConfig::CONFIG["host_cpu"],
+          # The receiver stores every SDK's language runtime version in its
+          # python_version field; "source" says which runtime this really is.
+          python_version: RUBY_VERSION,
+          run_count:      run_count,
+          timestamp:      now_iso
         }
 
         Thread.new { post(payload) }

data/lib/znyx_sdk.rb

@@ -3,5 +3,15 @@ require_relative "znyx_sdk/client"
 require_relative "znyx_sdk/telemetry"
 
 module ZnyxSdk
-  VERSION = "1.0.1"
+  # Resolved from the loaded gem spec, never a literal.
+  #
+  # The publish workflow stamps the release tag into ruby/*.gemspec ONLY, so a
+  # literal here is never updated by a release and goes stale - Telemetry#version
+  # reads this constant, so every install reported the same frozen number
+  # regardless of the gem version actually installed.
+  #
+  # Gem.loaded_specs is populated for the normal RubyGems/Bundler install path.
+  # A vendored source checkout has no spec, and is marked as obviously-unreal
+  # rather than guessing a number.
+  VERSION = (Gem.loaded_specs["znyx-sdk"]&.version&.to_s || "0.0.0+unknown").freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: znyx-sdk
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.2.2
 platform: ruby
 authors:
 - Zitrino
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-22 00:00:00.000000000 Z
+date: 2026-09-30 00:00:00.000000000 Z
 dependencies: []
 description:
 email: