blipit 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26c9f309ac743a11246ec29e103453393f9de8090a776825084447ab62b65a70
-  data.tar.gz: 5478afcc59b160311c19bd95979c5e199c7b24450923df33915d5ee073c308ef
+  metadata.gz: e3b3f5df2c1e54476b7900840749686a2fb0d3428f41722ccfe507431d52bbf7
+  data.tar.gz: 509a9d7e0673ea9a82600a798e6f4f71e8d5341633b46754b1e6292a2e4d94b2
 SHA512:
-  metadata.gz: 7645f41801bf2e2bde5f645ac1388f28f8b8cb9497c423792b1f0c4857e0dd06dd65724e48f79d7ba7659dc5ce17efebb73925feab767fc357698c9c7441f0ff
-  data.tar.gz: c81edf9b9a303104f76da895e5d02698a4dd66936e121f1a47a69ab24a364fe054ac8bb811572fb79d4c885a8bf208a8e2e56657687d281ed760d0390f821b17
+  metadata.gz: 8039c976e246061ceb6144765687e628708c7b317d414fc0e5cc6aa33231f4f857fe8d0b284457ace8abdaf11c8ab9eb974216ceabcbadfc1da4b7ac4513719b
+  data.tar.gz: 554c68f653f4c30640355ffc67353e386d81a0271a62aa699780d9af6446543305a381d188c6d8f2c0ae72f3344cc5aee9557dfe79cd33c8872b919e1b7b1bdb

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 0.2.1
+
+- Events carry the `gem:blipit` package and version, so the dashboard can show when this project runs an old Blipit SDK. A `before_send` you set still runs after it.
+- In development (`environment: "development"` or `debug: true`) the SDK warns once per process when a newer version is out: `[blipit] 0.2.2 is available (you have 0.2.1) — <why> — bundle update blipit`. It reads a header on the responses to events it already sends (no extra request); a custom `transport_class` is left alone. Nothing is printed in production.
+
 ## 0.2.0
 
 - `Blipit.init` with an empty key or project id prints a warning, returns false and leaves Blipit off instead of raising ArgumentError.

data/README.md

@@ -65,3 +65,7 @@ Both forms work. Without a kind or an actor it prints a warning and sends nothin
 Pass `traces_sample_rate: 0.2` to `init` and requests show up on the Performance page.
 
 Docs: https://docs.blipit.io/ruby
+
+## Updates
+
+In development Blipit prints one line when a newer version is out, with the reason and the command. Update with `bundle update blipit`. Details: https://docs.blipit.io/updates

data/lib/blipit/version.rb

@@ -1,3 +1,3 @@
 module Blipit
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/lib/blipit.rb

@@ -1,4 +1,6 @@
 require "sentry-ruby"
+require "json"
+require "uri"
 require_relative "blipit/version"
 
 if defined?(::Rails::Railtie)
@@ -24,6 +26,18 @@ module Blipit
                   "(Rails rescues them before they reach Ruby). Add gem \"sentry-rails\" to your Gemfile next to gem \"blipit\" " \
                   "and run bundle install."
   MISSING_ACTOR_WARNING = "[blipit] capture_security needs a kind and an actor, so this login attempt was not sent."
+  UPDATE_COMMAND = "bundle update blipit"
+  PACKAGE = { "name" => "gem:blipit", "version" => VERSION }.freeze
+
+  if Sentry::HTTPTransport.method_defined?(:do_request)
+    class NoticeTransport < Sentry::HTTPTransport
+      def do_request(*args)
+        response = super
+        Blipit.notice(response)
+        response
+      end
+    end
+  end
 
   class << self
     def dsn(key, project, endpoint = DEFAULT_ENDPOINT)
@@ -52,10 +66,53 @@ module Blipit
         config.send_default_pii = false
         options.each { |name, value| config.public_send("#{name}=", value) }
         yield config if block_given?
+        user_before_send = config.before_send
+        config.before_send = lambda do |event, hint|
+          with_identity(event)
+          user_before_send ? user_before_send.call(event, hint) : event
+        end
+        if (config.environment == "development" || config.debug) && config.transport.transport_class.nil? && defined?(NoticeTransport)
+          config.transport.transport_class = NoticeTransport
+        end
       end
       true
     end
 
+    def update_notice(header, current = VERSION)
+      latest = JSON.parse(URI.decode_www_form_component(header.to_s.gsub("+", "%2B")))
+      version = latest.is_a?(Hash) ? latest["version"] : nil
+      return nil unless version.is_a?(String) && !version.empty? && version != current
+
+      note = latest["note"].is_a?(String) ? latest["note"].strip : ""
+      why = note.empty? ? "" : " — #{note}"
+      "[blipit] #{version} is available (you have #{current})#{why} — #{UPDATE_COMMAND}"
+    rescue StandardError
+      nil
+    end
+
+    def notice(response)
+      return if @noticed
+
+      header = response["x-blipit-latest"]
+      line = header && update_notice(header)
+      return unless line
+
+      @noticed = true
+      warn(line)
+    rescue StandardError
+      nil
+    end
+
+    def with_identity(event)
+      sdk = event.sdk.is_a?(Hash) ? event.sdk : {}
+      packages = Array(sdk["packages"] || sdk[:packages])
+      return if packages.any? { |p| p.is_a?(Hash) && (p["name"] || p[:name]) == PACKAGE["name"] }
+
+      event.sdk = sdk.merge("packages" => packages + [PACKAGE.dup])
+    rescue StandardError
+      nil
+    end
+
     def capture_exception(error, **options)
       Sentry.capture_exception(error, **options)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: blipit
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Louward Labs
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-11 00:00:00.000000000 Z
+date: 2026-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger