telnyx 5.67.1 → 5.68.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f3b8590740640397076c7f6b1eab628663e927e9406aadf908189a76b33b4e3
-  data.tar.gz: 4ec8911776298b27482444aa517fd7afd894c98280f6a4ba70413f2b634762cf
+  metadata.gz: fc15a744f447e7c613e7e755a58535df1b6f45e5f2e224ca7c2ae0b34a047778
+  data.tar.gz: 647b8a4d529deb94ae909c30c7d1de71b00f5199f8caa7782508dd37550ca6a8
 SHA512:
-  metadata.gz: 81b41872a3170843489bc1e5216daaa329653e63d9622623456da81786649861dab07f285eb7ce020990e32f35b0c343e7692212f8086bcab4187a8e0657bb8f
-  data.tar.gz: 2a8dccdbf0cc5466d6a4eddc59857abb6e80142cd1c0695dbf444efc7e477a535247e78cc9b16bfebcc7e6de37b78d9807afed67524c8cc44fa5aaea60a381bb
+  metadata.gz: 67a69b663b07bc3507001555c0178d4a4de7c9bc61b656970c25ab236377ee34b91723fb32bc6b821095007582d164bc8c46109d4f870548fa0cd7b38e2c7296
+  data.tar.gz: 633e6228be91505a6693026b2e64404fcf6f452ad0de12157f7845a0643b2f3131cc08bd13bdbd325d856db865fafc2509891d9fff1671e670b7ddf8f7436f5c

data/CHANGELOG.md

@@ -1,5 +1,40 @@
 # 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)
+
+### Bug Fixes
+
+* **ci:** use correct rubygems OIDC action reference ([25859b2](https://github.com/team-telnyx/telnyx-ruby/commit/25859b2521364b0bbdf2e7d69ef709e22b30e3a4))
+
+## 5.68.0 (2026-03-30)
+
+Full Changelog: [v5.67.1...v5.68.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.67.1...v5.68.0)
+
+### Features
+
+* **ci:** switch to OIDC auth for RubyGems publishing ([9adb006](https://github.com/team-telnyx/telnyx-ruby/commit/9adb006d99fa6afb39568e5252f5445f13130a23))
+
+
+### Chores
+
+* **ci:** support opting out of skipping builds on metadata-only commits ([b965999](https://github.com/team-telnyx/telnyx-ruby/commit/b965999a809754eec80ea0a52d484e0af183fabe))
+
+
+### Documentation
+
+* fix voice settings available voices link ([0c73354](https://github.com/team-telnyx/telnyx-ruby/commit/0c73354fc70981237f2bfbdefd59b1229dfdcbf3))
+
+
+### Build System
+
+* **deps-dev:** bump activesupport from 8.1.1 to 8.1.2.1 ([#188](https://github.com/team-telnyx/telnyx-ruby/issues/188)) ([322ba2a](https://github.com/team-telnyx/telnyx-ruby/commit/322ba2afdc721a3126faa981d663b2d41cac86ea))
+
 ## 5.67.1 (2026-03-26)
 
 Full Changelog: [v5.67.0...v5.67.1](https://github.com/team-telnyx/telnyx-ruby/compare/v5.67.0...v5.67.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.67.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/models/ai/voice_settings.rb

@@ -6,7 +6,7 @@ module Telnyx
       class VoiceSettings < Telnyx::Internal::Type::BaseModel
         # @!attribute voice
         #   The voice to be used by the voice assistant. Check the full list of
-        #   [available voices](https://developers.telnyx.com/api/call-control/list-text-to-speech-voices)
+        #   [available voices](https://developers.telnyx.com/docs/tts-stt/tts-available-voices)
         #   via our voices API. To use ElevenLabs, you must reference your ElevenLabs API
         #   key as an integration secret under the `api_key_ref` field. See
         #   [integration secrets documentation](https://developers.telnyx.com/api-reference/integration-secrets/create-a-secret)

data/lib/telnyx/models/reputation_phone_number_with_reputation_data.rb

@@ -28,10 +28,10 @@ module Telnyx
       optional :phone_number, String
 
       # @!attribute reputation_data
-      #   Reputation metrics (null if not yet fetched)
+      #   Reputation metrics
       #
-      #   @return [Telnyx::Models::ReputationData, Hash{Symbol=>Object}, nil]
-      optional :reputation_data, union: -> { Telnyx::ReputationPhoneNumberWithReputationData::ReputationData }
+      #   @return [Telnyx::Models::ReputationData, nil]
+      optional :reputation_data, -> { Telnyx::ReputationData }
 
       # @!attribute updated_at
       #   When the record was last updated
@@ -48,27 +48,9 @@ module Telnyx
       #
       #   @param phone_number [String] Phone number in E.164 format
       #
-      #   @param reputation_data [Telnyx::Models::ReputationData, Hash{Symbol=>Object}, nil] Reputation metrics (null if not yet fetched)
+      #   @param reputation_data [Telnyx::Models::ReputationData] Reputation metrics
       #
       #   @param updated_at [Time] When the record was last updated
-
-      # Reputation metrics (null if not yet fetched)
-      #
-      # @see Telnyx::Models::ReputationPhoneNumberWithReputationData#reputation_data
-      module ReputationData
-        extend Telnyx::Internal::Type::Union
-
-        # Reputation metrics
-        variant -> { Telnyx::ReputationData }
-
-        variant -> { Telnyx::Models::ReputationPhoneNumberWithReputationData::ReputationData::EmptyReputationDataMap }
-
-        # @!method self.variants
-        #   @return [Array(Telnyx::Models::ReputationData, Hash{Symbol=>Object})]
-
-        # @type [Telnyx::Internal::Type::Converter]
-        EmptyReputationDataMap = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
-      end
     end
   end
 end

data/lib/telnyx/version.rb

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

data/rbi/telnyx/models/ai/voice_settings.rbi

@@ -10,7 +10,7 @@ module Telnyx
           end
 
         # The voice to be used by the voice assistant. Check the full list of
-        # [available voices](https://developers.telnyx.com/api/call-control/list-text-to-speech-voices)
+        # [available voices](https://developers.telnyx.com/docs/tts-stt/tts-available-voices)
         # via our voices API. To use ElevenLabs, you must reference your ElevenLabs API
         # key as an integration secret under the `api_key_ref` field. See
         # [integration secrets documentation](https://developers.telnyx.com/api-reference/integration-secrets/create-a-secret)
@@ -148,7 +148,7 @@ module Telnyx
         end
         def self.new(
           # The voice to be used by the voice assistant. Check the full list of
-          # [available voices](https://developers.telnyx.com/api/call-control/list-text-to-speech-voices)
+          # [available voices](https://developers.telnyx.com/docs/tts-stt/tts-available-voices)
           # via our voices API. To use ElevenLabs, you must reference your ElevenLabs API
           # key as an integration secret under the `api_key_ref` field. See
           # [integration secrets documentation](https://developers.telnyx.com/api-reference/integration-secrets/create-a-secret)

data/rbi/telnyx/models/reputation_phone_number_with_reputation_data.rbi

@@ -39,24 +39,11 @@ module Telnyx
       sig { params(phone_number: String).void }
       attr_writer :phone_number
 
-      # Reputation metrics (null if not yet fetched)
-      sig do
-        returns(
-          T.nilable(
-            Telnyx::ReputationPhoneNumberWithReputationData::ReputationData::Variants
-          )
-        )
-      end
+      # Reputation metrics
+      sig { returns(T.nilable(Telnyx::ReputationData)) }
       attr_reader :reputation_data
 
-      sig do
-        params(
-          reputation_data:
-            T.nilable(
-              T.any(Telnyx::ReputationData::OrHash, T::Hash[Symbol, T.anything])
-            )
-        ).void
-      end
+      sig { params(reputation_data: Telnyx::ReputationData::OrHash).void }
       attr_writer :reputation_data
 
       # When the record was last updated
@@ -72,10 +59,7 @@ module Telnyx
           created_at: Time,
           enterprise_id: String,
           phone_number: String,
-          reputation_data:
-            T.nilable(
-              T.any(Telnyx::ReputationData::OrHash, T::Hash[Symbol, T.anything])
-            ),
+          reputation_data: Telnyx::ReputationData::OrHash,
           updated_at: Time
         ).returns(T.attached_class)
       end
@@ -88,7 +72,7 @@ module Telnyx
         enterprise_id: nil,
         # Phone number in E.164 format
         phone_number: nil,
-        # Reputation metrics (null if not yet fetched)
+        # Reputation metrics
         reputation_data: nil,
         # When the record was last updated
         updated_at: nil
@@ -102,44 +86,13 @@ module Telnyx
             created_at: Time,
             enterprise_id: String,
             phone_number: String,
-            reputation_data:
-              T.nilable(
-                Telnyx::ReputationPhoneNumberWithReputationData::ReputationData::Variants
-              ),
+            reputation_data: Telnyx::ReputationData,
             updated_at: Time
           }
         )
       end
       def to_hash
       end
-
-      # Reputation metrics (null if not yet fetched)
-      module ReputationData
-        extend Telnyx::Internal::Type::Union
-
-        Variants =
-          T.type_alias do
-            T.nilable(
-              T.any(Telnyx::ReputationData, T::Hash[Symbol, T.anything])
-            )
-          end
-
-        sig do
-          override.returns(
-            T::Array[
-              Telnyx::ReputationPhoneNumberWithReputationData::ReputationData::Variants
-            ]
-          )
-        end
-        def self.variants
-        end
-
-        EmptyReputationDataMap =
-          T.let(
-            Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
-            Telnyx::Internal::Type::Converter
-          )
-      end
     end
   end
 end

data/sig/telnyx/models/reputation_phone_number_with_reputation_data.rbs

@@ -6,7 +6,7 @@ module Telnyx
         created_at: Time,
         enterprise_id: String,
         phone_number: String,
-        reputation_data: Telnyx::Models::ReputationPhoneNumberWithReputationData::reputation_data?,
+        reputation_data: Telnyx::ReputationData,
         updated_at: Time
       }
 
@@ -27,11 +27,9 @@ module Telnyx
 
       def phone_number=: (String) -> String
 
-      attr_reader reputation_data: Telnyx::Models::ReputationPhoneNumberWithReputationData::reputation_data?
+      attr_reader reputation_data: Telnyx::ReputationData?
 
-      def reputation_data=: (
-        Telnyx::Models::ReputationPhoneNumberWithReputationData::reputation_data?
-      ) -> Telnyx::Models::ReputationPhoneNumberWithReputationData::reputation_data?
+      def reputation_data=: (Telnyx::ReputationData) -> Telnyx::ReputationData
 
       attr_reader updated_at: Time?
 
@@ -42,7 +40,7 @@ module Telnyx
         ?created_at: Time,
         ?enterprise_id: String,
         ?phone_number: String,
-        ?reputation_data: Telnyx::Models::ReputationPhoneNumberWithReputationData::reputation_data?,
+        ?reputation_data: Telnyx::ReputationData,
         ?updated_at: Time
       ) -> void
 
@@ -51,19 +49,9 @@ module Telnyx
         created_at: Time,
         enterprise_id: String,
         phone_number: String,
-        reputation_data: Telnyx::Models::ReputationPhoneNumberWithReputationData::reputation_data?,
+        reputation_data: Telnyx::ReputationData,
         updated_at: Time
       }
-
-      type reputation_data = (Telnyx::ReputationData | ::Hash[Symbol, top])?
-
-      module ReputationData
-        extend Telnyx::Internal::Type::Union
-
-        def self?.variants: -> ::Array[Telnyx::Models::ReputationPhoneNumberWithReputationData::reputation_data]
-
-        EmptyReputationDataMap: Telnyx::Internal::Type::Converter
-      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telnyx
 version: !ruby/object:Gem::Version
-  version: 5.67.1
+  version: 5.68.2
 platform: ruby
 authors:
 - Telnyx
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-26 00:00:00.000000000 Z
+date: 2026-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -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