mailkube 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62f56b63852a247583a1bbb34cbe7f816ecfdfcbbaf672281b1e4396a697c8e7
-  data.tar.gz: c12d752ba809c48b7d7cf6d1cade536b839be61279d2109d2320c96ee187c3bb
+  metadata.gz: 11e623e291d499bfa611c9eb8e4e768b8a93dbffafe84422dfc0692f0e4c719a
+  data.tar.gz: 2f945465f2bb22cd7633aeb05901f53a48311d41c748c216264c8862720f50bc
 SHA512:
-  metadata.gz: 3dd9768193d7ca0a700cdb6d6af906ddb33533adc9182de122be1debb9617cf000899b0102e396549cf55c19e1c3df26ec9d6cf8f94d8b15f676fcede3841f9b
-  data.tar.gz: b5daed405e91f130357dd2a65e5e03284f5616d2676ce6b0d4eb53adff715a004f07594d6e70d051aa9681e1fe8aebbfff4da0f477222a99307cbd2fff900f3b
+  metadata.gz: 4d02cc6a359397afb79581541156aa4f6774b7f187c798d63d4e3e2923024e095d40c5d7676c5024b6b319bffc28bec7ed9c89be98d668c8300ae6c5b5155ac2
+  data.tar.gz: 4ee50cef68dfaaae7a8dacc2c76ab6b6bb02e5fbaa4f642014c6224ce45ba90d8e72558a98a1ee009b480cc6b0711b185d6a4fb58f4bcb60f48e454bc365c32e

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.0"
 end

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.0
 platform: ruby
 authors:
-- Mailtactic, Corp.
+- Mail Tactic Corporation
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z