cekat-event-sdk 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2916e118d56407e2f21b5e4520936221b46bc3d46a5744e24c1612f8b755a2ca
-  data.tar.gz: 206f9d1eb0068e404d1f1b510c767be62889b8de15877dace4b73320f3b9d05b
+  metadata.gz: a6adabdca7dc48bd4594f7368316096ea0bb0bd5d928ad0ccf36d9866ee555b6
+  data.tar.gz: 66e3f5464caf285279b3910ce02ea649286d28830e5119a7de3d2977745aa6e5
 SHA512:
-  metadata.gz: f33ec335fe1a10dcd10272a112ce49f80e2253dc786c9d8aeb1b7c51fb7df260ec9195fee184a6e4fafa2b7870d9c04744d1856cf6f2badeb5c3c9aee4d21700
-  data.tar.gz: b305914695eaaf96983c1b2ced8f4f5c78ead1d9b27f52b58c9afc0b330c21499e1de0ed240349e3736f8853ad3a7b195e44e81a6a8bd74ee6eb77a3809962c5
+  metadata.gz: b7c30741a7eb8a011206329680efc87c1e3d504db9953390b3e482c40719f536dd8f50b8189b709f41d0eea9d46849f0c76d0654170f680d21fd21b64cb91556
+  data.tar.gz: c27f710403a0efebad517e77be27ed6cb17076be9d50abb7a0d1d70301b97303a6a01512e1ed80ca7661dc740b3553a8639a963f4c958b441b70b97bd9a35bae

data/README.md

@@ -72,6 +72,18 @@ end
 
 The visitor scope lives in fiber storage (`Fiber[]`), so it is isolated per request under threaded servers (Puma) and fiber-based servers (Falcon). Every scope restores the previous visitor when it ends, including when it raises, so long-running workers never leak a visitor ID between requests. Threads and fibers started inside a request begin with a copy of its scope. The scope ends when the middleware returns, so events emitted while a streaming response body is iterated must pass `visitor_id:` explicitly.
 
+## Stripe metadata composition
+
+Use the helper with the merchant's Stripe client; it does not create a Stripe request or send a Cekat event.
+
+```ruby
+metadata = CekatEventSdk::Stripe.merge_metadata(merchant_metadata, CekatEventSdk::Stripe.metadata_from_current_visitor["cekat_" + "visitor_id"])
+# stripe.payment_intents.create(amount: 1200, currency: "usd", metadata: metadata)
+# stripe.checkout.sessions.create(mode: "payment", metadata: metadata, payment_intent_data: { metadata: metadata })
+```
+
+Only a trimmed 1–128 character `[A-Za-z0-9_-]` visitor becomes the Stripe visitor metadata entry. Merge returns a fresh hash, preserving merchant keys and leaving invalid or absent visitor input unchanged.
+
 ## Keep tracking off the request's critical path
 
 Calls are synchronous, so each event adds its round-trip to the request. To send in the background, capture the visitor ID while the request scope is active and pass it explicitly:
@@ -132,7 +144,7 @@ The Net::HTTP transport opens a fresh connection per attempt, never follows redi
 bundle install
 bundle exec rake            # core, Rack, and Rails specs plus RuboCop
 RAILS_VERSION="~> 8.0.0" RACK_VERSION="~> 2.2" bundle update && bundle exec rake spec
-./scripts/package --version 0.1.0 --output /absolute/empty-directory
+./scripts/package --version 0.2.0 --output /absolute/empty-directory
 ```
 
 `scripts/package` runs the specs, RuboCop, and `bundle-audit`, then builds the gem and a SHA-256 `manifest.json`. It never pushes, signs, or tags; releases to RubyGems run from the repository's `release-ruby.yml` workflow when a `ruby/vX.Y.Z` tag is pushed. `scripts/conformance` runs the shared conformance fixtures (see `conformance/README.md`); the three caller-cancellation cases are reported as `not_applicable` for Ruby.

data/lib/cekat_event_sdk/stripe.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module CekatEventSdk
+  # Builds Stripe metadata for optional Cekat visitor correlation.
+  module Stripe
+    VISITOR_METADATA_KEY = "cekat_visitor_id"
+
+    module_function
+
+    def metadata_for_visitor(visitor_id)
+      normalized = valid_visitor_id(visitor_id)
+      normalized.nil? ? {} : { VISITOR_METADATA_KEY => normalized }
+    end
+
+    def metadata_from_current_visitor
+      metadata_for_visitor(VisitorContext.current_visitor_id)
+    end
+
+    def merge_metadata(metadata, visitor_id)
+      merged = metadata.dup
+      normalized = valid_visitor_id(visitor_id)
+      merged[VISITOR_METADATA_KEY] = normalized unless normalized.nil?
+      merged
+    end
+
+    def valid_visitor_id(visitor_id)
+      return nil unless visitor_id.is_a?(String)
+
+      normalized = visitor_id.strip
+      return nil unless normalized.match?(/\A[A-Za-z0-9_-]{1,128}\z/)
+
+      normalized
+    end
+    private_class_method :valid_visitor_id
+  end
+end

data/lib/cekat_event_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CekatEventSdk
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/cekat_event_sdk.rb

@@ -16,6 +16,7 @@ require_relative "cekat_event_sdk/event_input"
 require_relative "cekat_event_sdk/acknowledgement"
 require_relative "cekat_event_sdk/visitor_id_resolver"
 require_relative "cekat_event_sdk/visitor_context"
+require_relative "cekat_event_sdk/stripe"
 require_relative "cekat_event_sdk/payload_builder"
 require_relative "cekat_event_sdk/retry_policy"
 require_relative "cekat_event_sdk/transport"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cekat-event-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Cekat
@@ -29,6 +29,7 @@ files:
 - lib/cekat_event_sdk/rails.rb
 - lib/cekat_event_sdk/response_decoder.rb
 - lib/cekat_event_sdk/retry_policy.rb
+- lib/cekat_event_sdk/stripe.rb
 - lib/cekat_event_sdk/transport.rb
 - lib/cekat_event_sdk/version.rb
 - lib/cekat_event_sdk/visitor_context.rb