mailkube 1.1.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62f56b63852a247583a1bbb34cbe7f816ecfdfcbbaf672281b1e4396a697c8e7
-  data.tar.gz: c12d752ba809c48b7d7cf6d1cade536b839be61279d2109d2320c96ee187c3bb
+  metadata.gz: afd85d0c480e7cff16fd2df6344b221acf946f644e97e7f9d7b33f2472ac5c51
+  data.tar.gz: 32f66b35b8f0e9631ca737ffcc1c51b6e1b98be6746f9a1d4019c623ce24e9ff
 SHA512:
-  metadata.gz: 3dd9768193d7ca0a700cdb6d6af906ddb33533adc9182de122be1debb9617cf000899b0102e396549cf55c19e1c3df26ec9d6cf8f94d8b15f676fcede3841f9b
-  data.tar.gz: b5daed405e91f130357dd2a65e5e03284f5616d2676ce6b0d4eb53adff715a004f07594d6e70d051aa9681e1fe8aebbfff4da0f477222a99307cbd2fff900f3b
+  metadata.gz: e7d1a7c1e83031bbd5fca5533ecff6635361726c401b20112e856d3b62ca62211764c3498501a36d9907a6de7a2b9d0d0304d0002a725f4f4c8c013c6e3a35d0
+  data.tar.gz: 9c7ecae8c33e302db1a539d4fbc88ec46bd1b3edf60cda62820e7b4d3ae8d499d67f116736bec04a6445f50692dc3b7a76d108b2e209e9faa983eac9890a1a17

data/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2026 Mailtactic, Corp.
+   Copyright 2026 Mail Tactic Corporation
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

data/NOTICE

@@ -1,11 +1,8 @@
 mailkube-ruby
-Copyright 2026 Mailtactic, Corp.
+Copyright 2026 Mail Tactic Corporation
 
 This product is licensed under the Apache License, Version 2.0 (the "License");
 you may not use this product except in compliance with the License. You may
 obtain a copy of the License at:
 
     http://www.apache.org/licenses/LICENSE-2.0
-
-"mailkube" is a trademark of Mailtactic, Corp. Use of the name is governed by
-Section 6 (Trademarks) of the License.

data/README.md

@@ -240,6 +240,12 @@ implement it.
 Every `email.*` payload also carries the message context: `email_id`, `created_at`, `domain`,
 `subject`, `to`, `from` and `tags`.
 
+On the `data.open` and `data.click` blocks, `ip_address`, `country` and `user_agent` are recorded
+only where the sending domain has elected them, and both settings are off by default. The server
+omits the key rather than sending an empty value, so the accessor returns `nil` when it was not
+recorded. `country` can be `nil` even where the address was recorded, because it is resolved at the
+edge and is not available on every path.
+
 Two guarantees hold for every released version, so a platform change never breaks a running
 receiver:
 
@@ -336,4 +342,4 @@ must pass. Security issues: see [SECURITY.md](SECURITY.md).
 
 ## License
 
-[Apache-2.0](LICENSE) © 2026 Mailtactic, Corp.
+[Apache-2.0](LICENSE) © 2026 Mail Tactic Corporation

data/lib/mailkube/events/contexts.rb

@@ -63,10 +63,19 @@ module Mailkube
     # These nested keys are camelCase on the wire, unlike every other block here. The SDK mirrors
     # the server rather than normalizing it.
     class EngagementContext < Node
-      # @return [String] the opening client's IP address (wire key `ipAddress`).
+      # The three connection accessors return nil unless the sending domain elected to record the
+      # field, which is off by default. The server omits the key rather than sending a blank, so
+      # nil here means "the sender did not record this" and never "the sender recorded an empty
+      # value".
+      #
+      # @return [String, nil] the opening client's IP address (wire key `ipAddress`).
       def ip_address = self["ipAddress"]
-      # @return [String] the opening client's user agent (wire key `userAgent`).
+      # @return [String, nil] the opening client's user agent (wire key `userAgent`).
       def user_agent = self["userAgent"]
+      # Elected together with {#ip_address}, but can still be nil when the address was recorded:
+      # it is resolved at the edge and is not available on every path.
+      # @return [String, nil] the two-letter country the address resolves to.
+      def country = self["country"]
       # @return [String] when the interaction was recorded.
       def timestamp = self["timestamp"]
     end

data/lib/mailkube/version.rb

@@ -11,5 +11,5 @@ module Mailkube
   # semantic-release rewrites this line **in the release runner** just before the gem is built, and
   # commits nothing back to `main` (see `.rules/RELEASE.md`). So a checkout reports `0.0.0` and an
   # installed gem reports the real version: that is intended, not a bug to fix by hardcoding one.
-  VERSION = "1.1.0"
+  VERSION = "1.2.1"
 end

data/lib/mailkube/webhooks.rb

@@ -15,8 +15,15 @@ module Mailkube
     # The prefix the server puts before the hex digest in `X-Webhook-Sig`.
     SIGNATURE_PREFIX = "sha256="
     # Decode webhook payloads deep-frozen, so a receiver cannot mutate an event it is about to
-    # forward or log. Passed **positionally** because that is the shape `JSON.parse` declares
-    # (`(source, opts)`); as keywords Steep reports an unexpected keyword.
+    # forward or log. Splatted as **keywords** at the call site, because json 3.0 made every
+    # `JSON.parse` option keyword-only: a positional hash now raises `ArgumentError`, and it is
+    # not coming back (ruby/json#1078 is closed as "not planned" — only `JSON.dump`'s positional
+    # `limit` was restored, in 3.0.1).
+    #
+    # The splat is also the compatible direction, which is why there is no `json` floor in the
+    # gemspec and the gem stays stdlib-only: json 2.x declares `(source, opts = nil)`, and Ruby
+    # collects keywords into the trailing positional Hash for a method that declares none. One
+    # call site, both majors. Verified against json 2.21.2 and 3.0.2 on Ruby 3.4.
     PARSE_OPTIONS = { freeze: true }.freeze
 
     # Verify a webhook's signature and timestamp freshness over the raw body.
@@ -65,7 +72,7 @@ module Mailkube
     # @return [Events::Event] the parsed event; narrow it with `case` or `is_a?`.
     # @raise [Error] when the body is not a JSON object.
     def self.parse_event(payload)
-      body = JSON.parse(payload, PARSE_OPTIONS)
+      body = JSON.parse(payload, **PARSE_OPTIONS)
       raise Error, "webhook payload is not a JSON object" unless body.is_a?(Hash)
 
       Events::REGISTRY.fetch(body["type"], Events::UnknownEvent).new(body)

data/sig/mailkube/events/contexts.rbs

@@ -22,8 +22,9 @@ module Mailkube
     end
 
     class EngagementContext < Node
-      def ip_address: () -> String
-      def user_agent: () -> String
+      def ip_address: () -> String?
+      def user_agent: () -> String?
+      def country: () -> String?
       def timestamp: () -> String
     end
 

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: mailkube
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.1
 platform: ruby
 authors:
-- Mailtactic, Corp.
+- Mail Tactic Corporation
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z