telnyx 5.71.0 → 5.72.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 55892760f556bee9521d8c638235b5dce702cea3c1766f230318952e9db8f8ab
-  data.tar.gz: bfa439dd1d25de410cd87030b3a86f119b068e922ed4f74821c6028fc9beb3bf
+  metadata.gz: d4b500a4bc4109025ba78f82c49404d3013e7503c76f1d9c8634b3acafbab842
+  data.tar.gz: 10cf9319219e298027dc388a87825bd3edd259ffdeead4f22296ed2a69c6a0e2
 SHA512:
-  metadata.gz: ed548d98590649ba4b7e628a4f2955f1a40c6ba9e78b6268d396a7ed400e6e6870c39951bdb70fdd21f0ab10187767a752b59fba7e493539c37fd26d996a438b
-  data.tar.gz: d8ae515be892c263d2a85a0ee1b60531aca724fe39973e5b148c32bfa6cb5c58ce37a7bf3ae5d92d41f146c4cdc5bd887970cf9df3dd246ce8d17a9b89c20da9
+  metadata.gz: b9f7f8f34ba648a1ec8309a25a958b2cfccb5e8f4f78753110353ba7795b5d82191d2939ce8bc7890f91b174875349ca89d7161cf11bc8171311c75c282e0724
+  data.tar.gz: 1ce14a74710071dabcf31b1c5046172211879613dfe534cadf77783cf66e696bf557a15ade2928eaf5de7f3aa6637c93d4b83b22c0f78bb738c2d36f842559c3

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 5.72.0 (2026-04-11)
+
+Full Changelog: [v5.71.0...v5.72.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.71.0...v5.72.0)
+
+### Features
+
+* **lib:** make ED25519 the default webhook verification ([c281219](https://github.com/team-telnyx/telnyx-ruby/commit/c2812192677e731ddf6b6702590f7e55d2f3ef68))
+
+
+### Bug Fixes
+
+* **lib:** move ED25519 auto-require to lib.rb entry point to survive codegen ([7f38f2c](https://github.com/team-telnyx/telnyx-ruby/commit/7f38f2cf33fb3c8391ce7d8f86c88513d7edc907))
+* **lib:** update webhook tests for ED25519 default unwrap ([30ac4c7](https://github.com/team-telnyx/telnyx-ruby/commit/30ac4c7d1fc66732ba5dc55824d3876b4dd120f0))
+
 ## 5.71.0 (2026-04-11)
 
 Full Changelog: [v5.70.0...v5.71.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.70.0...v5.71.0)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.71.0"
+gem "telnyx", "~> 5.72.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/lib/webhook_verification.rb

@@ -150,7 +150,20 @@ module Telnyx
         # The raw 32-byte key needs to be wrapped in X.509 SubjectPublicKeyInfo format
         # ED25519 OID: 1.3.101.112 = 06 03 2b 65 70
         # X.509 SPKI header for ED25519: 30 2a 30 05 06 03 2b 65 70 03 21 00
-        ed25519_spki_header = [0x30, 0x2a, 0x30, 0x05, 0x06, 0x03, 0x2b, 0x65, 0x70, 0x03, 0x21, 0x00].pack("C*")
+        ed25519_spki_header = [
+          0x30,
+          0x2a,
+          0x30,
+          0x05,
+          0x06,
+          0x03,
+          0x2b,
+          0x65,
+          0x70,
+          0x03,
+          0x21,
+          0x00
+        ].pack("C*")
         der_key = ed25519_spki_header + public_key_bytes
 
         begin

data/lib/telnyx/lib/webhooks_ed25519.rb

@@ -3,48 +3,61 @@
 require_relative "webhook_verification"
 require_relative "webhook_verification_error"
 
-module Telnyx
-  module Resources
-    # Extends the generated Webhooks class with ED25519 signature verification.
-    #
-    # This reopens the Webhooks class to include the WebhookVerification module,
-    # which adds ED25519 signature verification matching Python, Node, Go, and Java SDKs.
-    #
-    # Usage:
-    #
-    #   require "telnyx"
-    #   require "telnyx/lib/webhooks_ed25519"
-    #
-    #   client = Telnyx::Client.new(
-    #     api_key: ENV["TELNYX_API_KEY"],
-    #     public_key: ENV["TELNYX_PUBLIC_KEY"]  # Base64 from Mission Control
-    #   )
-    #
-    #   # Verify signature only (raises WebhookVerificationError on failure)
-    #   client.webhooks.verify!(payload, headers)
-    #
-    #   # Verify and parse (ED25519 verification, then parse)
-    #   event = client.webhooks.unwrap(payload, headers: headers)
-    #
-    class Webhooks
-      include Telnyx::Lib::WebhookVerification
-
-      # Override unwrap to use ED25519 verification instead of StandardWebhooks.
+# Only apply the ED25519 override if the generated Webhooks class exists.
+# This file is loaded after lib/telnyx/resources/webhooks.rb in the gem
+# load order (see lib/telnyx.rb), so the class should always be defined.
+if defined?(Telnyx::Resources::Webhooks)
+  module Telnyx
+    module Resources
+      # Extends the generated Webhooks class with ED25519 signature verification.
+      #
+      # This reopens the Webhooks class to include the WebhookVerification module,
+      # which adds ED25519 signature verification matching Python, Node, Go, and Java SDKs.
+      #
+      # Usage:
+      #
+      #   require "telnyx"
+      #   # ED25519 verification is now loaded by default — no extra require needed
       #
-      # @param payload [String] The raw webhook payload as a string
-      # @param headers [Hash{String=>String}] The raw HTTP headers
-      # @param key [String, nil] Optional public key override (base64-encoded ED25519)
+      #   client = Telnyx::Client.new(
+      #     api_key: ENV["TELNYX_API_KEY"],
+      #     public_key: ENV["TELNYX_PUBLIC_KEY"]  # Base64 from Mission Control
+      #   )
       #
-      # @return [Telnyx::Models::UnwrapWebhookEvent]
-      # @raise [Telnyx::Errors::WebhookVerificationError] If verification fails
-      def unwrap(payload, headers:, key: nil)
-        # Use ED25519 verification
-        do_verify_signature(payload, headers, key || @client.public_key)
+      #   # Verify signature only (raises WebhookVerificationError on failure)
+      #   client.webhooks.verify!(payload, headers)
+      #
+      #   # Verify and parse (ED25519 verification, then parse)
+      #   event = client.webhooks.unwrap(payload, headers: headers)
+      #
+      class Webhooks
+        include Telnyx::Lib::WebhookVerification
+
+        # Override unwrap to use ED25519 verification instead of StandardWebhooks.
+        #
+        # @param payload [String] The raw webhook payload as a string
+        # @param headers [Hash{String=>String}] The raw HTTP headers
+        # @param key [String, nil] Optional public key override (base64-encoded ED25519)
+        #
+        # @return [Telnyx::Models::UnwrapWebhookEvent]
+        # @raise [Telnyx::Errors::WebhookVerificationError] If verification fails
+        def unwrap(payload, headers:, key: nil)
+          # Use ED25519 verification
+          do_verify_signature(payload, headers, key || @client.public_key)
 
-        # Parse the payload
-        parsed = JSON.parse(payload, symbolize_names: true)
-        Telnyx::Internal::Type::Converter.coerce(Telnyx::Models::UnwrapWebhookEvent, parsed)
+          # Parse the payload
+          parsed = JSON.parse(payload, symbolize_names: true)
+          Telnyx::Internal::Type::Converter.coerce(Telnyx::Models::UnwrapWebhookEvent, parsed)
+        end
       end
     end
   end
+else
+  # If the generated Webhooks class isn't loaded yet, the ED25519 override
+  # can't be applied. This shouldn't happen in normal gem usage since
+  # lib/telnyx.rb loads resources before lib/. If you see this warning,
+  # ensure lib/telnyx.rb requires lib/telnyx/lib after the resources.
+  warn "[telnyx] ED25519 webhook verification not loaded: " \
+       "Telnyx::Resources::Webhooks is not defined. " \
+       "Check that lib/telnyx.rb loads resources before lib/telnyx/lib."
 end

data/lib/telnyx/lib.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Custom lib entry point — preserved across Stainless codegen.
+#
+# This file requires all custom modules in lib/telnyx/lib/.
+# It is loaded from lib/telnyx.rb (the gem entry point).
+#
+# If Stainless regenerates lib/telnyx.rb, the require_relative line
+# pointing to this file must be re-added. All other custom code
+# lives here and in lib/telnyx/lib/ — safe from codegen.
+#
+# Add new custom modules below:
+
+require_relative "lib/webhooks_ed25519"

data/lib/telnyx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telnyx
-  VERSION = "5.71.0"
+  VERSION = "5.72.0"
 end

data/lib/telnyx.rb

@@ -2703,3 +2703,7 @@ require_relative "telnyx/resources/wireless_blocklists"
 require_relative "telnyx/resources/wireless_blocklist_values"
 require_relative "telnyx/resources/x402"
 require_relative "telnyx/resources/x402/credit_account"
+
+# Custom lib entry point — preserved across codegen.
+# If this line is lost after a Stainless codegen run, it must be re-added.
+require_relative "telnyx/lib"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: telnyx
 version: !ruby/object:Gem::Version
-  version: 5.71.0
+  version: 5.72.0
 platform: ruby
 authors:
 - Telnyx
@@ -93,6 +93,7 @@ files:
 - lib/telnyx/internal/type/union.rb
 - lib/telnyx/internal/type/unknown.rb
 - lib/telnyx/internal/util.rb
+- lib/telnyx/lib.rb
 - lib/telnyx/lib/webhook_verification.rb
 - lib/telnyx/lib/webhook_verification_error.rb
 - lib/telnyx/lib/webhooks_ed25519.rb