telnyx 5.68.1 → 5.68.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f34b351e46a139b2d8217472217b09e421a8d04aee53e3597ab260cb8e6ab9cc
-  data.tar.gz: 17836f25c4cbcdab85c8c6c093806b0772eb3f4b036fed47804e702fb603a6a1
+  metadata.gz: fc15a744f447e7c613e7e755a58535df1b6f45e5f2e224ca7c2ae0b34a047778
+  data.tar.gz: 647b8a4d529deb94ae909c30c7d1de71b00f5199f8caa7782508dd37550ca6a8
 SHA512:
-  metadata.gz: f83976ff044d8e994a43a5fe1a3f5f38367e427f91bb3918c892025967c40eeba308d751a961a2006f41c6e39d920a2e77701ba65ad45b0b5534bb274ac6c869
-  data.tar.gz: 8251c6427f0ba4b6c5a244558157315163f08c943848d943e377e2cb40885fd55da15a36fd7f3aa09df191ada92912b0ff3713959f8de5e4760465b03c99aa3d
+  metadata.gz: 67a69b663b07bc3507001555c0178d4a4de7c9bc61b656970c25ab236377ee34b91723fb32bc6b821095007582d164bc8c46109d4f870548fa0cd7b38e2c7296
+  data.tar.gz: 633e6228be91505a6693026b2e64404fcf6f452ad0de12157f7845a0643b2f3131cc08bd13bdbd325d856db865fafc2509891d9fff1671e670b7ddf8f7436f5c

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 5.68.2 (2026-03-31)
+
+Full Changelog: [v5.68.1...v5.68.2](https://github.com/team-telnyx/telnyx-ruby/compare/v5.68.1...v5.68.2)
+
 ## 5.68.1 (2026-03-31)
 
 Full Changelog: [v5.68.0...v5.68.1](https://github.com/team-telnyx/telnyx-ruby/compare/v5.68.0...v5.68.1)

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.68.1"
+gem "telnyx", "~> 5.68.2"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/lib/webhook_verification.rb

@@ -2,6 +2,7 @@
 
 require "base64"
 require "openssl"
+require_relative "webhook_verification_error"
 
 module Telnyx
   module Lib

data/lib/telnyx/lib/webhook_verification_error.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Errors
+    # Error raised when webhook signature verification fails.
+    #
+    # This error is raised by the webhook verification module when:
+    # - No public key is configured
+    # - Required headers are missing (telnyx-signature-ed25519, telnyx-timestamp)
+    # - Timestamp is too old or too new (outside 5-minute tolerance)
+    # - Signature verification fails
+    # - Public key or signature format is invalid
+    #
+    # @example Handling verification errors
+    #   begin
+    #     client.webhooks.verify!(payload, headers)
+    #   rescue Telnyx::Errors::WebhookVerificationError => e
+    #     puts "Webhook verification failed: #{e.message}"
+    #   end
+    class WebhookVerificationError < StandardError
+      # @param message [String] The error message describing the verification failure
+      def initialize(message:)
+        super(message)
+      end
+    end
+  end
+end

data/lib/telnyx/lib/webhooks_ed25519.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+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.
+      #
+      # @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)
+      end
+    end
+  end
+end

data/lib/telnyx/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: telnyx
 version: !ruby/object:Gem::Version
-  version: 5.68.1
+  version: 5.68.2
 platform: ruby
 authors:
 - Telnyx
@@ -94,6 +94,8 @@ files:
 - lib/telnyx/internal/type/unknown.rb
 - lib/telnyx/internal/util.rb
 - lib/telnyx/lib/webhook_verification.rb
+- lib/telnyx/lib/webhook_verification_error.rb
+- lib/telnyx/lib/webhooks_ed25519.rb
 - lib/telnyx/lib/websocket.rb
 - lib/telnyx/lib/websocket/base.rb
 - lib/telnyx/lib/websocket/speech_to_text_stream_params.rb