telnyx 2.9.0 → 3.0.0

data/VERSION

@@ -1 +1 @@
-2.9.0
+3.1.0

data/lib/telnyx/access_control_ip.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class AccessIPAddress < APIResource
+    include APIOperations::Delete
+    include APIOperations::Save
+    extend APIOperations::List
+    extend APIOperations::Create
+
+    OBJECT_NAME = "access_ip_address".freeze
+    RESOURCE_PATH = "access_ip_addresses".freeze
+  end
+end

data/lib/telnyx/access_ip_range.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class AccessIPRange < APIResource
+    include APIOperations::Delete
+    include APIOperations::Save
+    extend APIOperations::List
+    extend APIOperations::Create
+
+    OBJECT_NAME = "access_ip_range".freeze
+  end
+end

data/lib/telnyx/address.rb

@@ -5,6 +5,15 @@ module Telnyx
     include APIOperations::Delete
     extend APIOperations::List
     extend APIOperations::Create
+    extend Telnyx::APIOperations::NestedResource
+
+    ACTIONS = %w[validate].freeze
+    ACTIONS.each do |action|
+      nested_resource_class_methods action,
+                                    path: %W[actions #{action}],
+                                    operations: [:create],
+                                    instance_methods: { create: action }
+    end
 
     OBJECT_NAME = "address".freeze
     RESOURCE_PATH = "addresses".freeze

data/lib/telnyx/api_operations/delete.rb

@@ -6,7 +6,7 @@ module Telnyx
       def delete(params = {}, opts = {})
         opts = Util.normalize_opts(opts)
         resp, opts = request(:delete, resource_url, params, opts)
-        initialize_from(resp.data[:data], opts)
+        initialize_from(resp.data[:data], opts) if resp.data[:data].present? # at deletion resp[:data] not present for some apis
       end
     end
   end

data/lib/telnyx/api_resource.rb

@@ -33,7 +33,10 @@ module Telnyx
       return "/v2/#{resource_path(inner_id)}" if respond_to?("resource_path")
       return "/v2/#{self::RESOURCE_PATH}" if const_defined?("RESOURCE_PATH")
 
-      "/v2/#{self::OBJECT_NAME.downcase.tr('.', '/')}s"
+      object_name = self::OBJECT_NAME.downcase
+      keywords = %w[generate summarize global_ip_usage global_ip_latency global_ip_assignment_usage global_ip_assignment_health sub_request campaign]
+      url_segment = object_name.tr(".", "/")
+      keywords.any? { |keyword| url_segment.include?(keyword) } ? "/v2/#{url_segment}" : "/v2/#{url_segment}s"
     end
 
     def self.identified_resource_url(id)

data/lib/telnyx/authentication_providers.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class AuthenticationProviders < APIResource
+    include APIOperations::Delete
+    include APIOperations::Save
+    extend APIOperations::List
+    extend APIOperations::Create
+
+    OBJECT_NAME = "authentication_providers".freeze
+  end
+end

data/lib/telnyx/available_phone_number.rb

@@ -6,6 +6,11 @@ module Telnyx
     extend Telnyx::APIOperations::ParamWrapper
     wrap "list", "filter"
 
+    def self.blocks(params = {}, opts = {})
+      resp, opts = request(:get, "/v2/available_phone_number_blocks", params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
+
     OBJECT_NAME = "available_phone_number".freeze
   end
 end

data/lib/telnyx/balance.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class AccessIPRange < APIResource
+    include APIOperations::Delete
+    include APIOperations::Save
+    extend APIOperations::List
+    extend APIOperations::Create
+
+    OBJECT_NAME = "balance".freeze
+  end
+end

data/lib/telnyx/batch_mdr_report.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class BatchMdrReport < APIResource
+    extend APIOperations::List
+    extend APIOperations::Create
+    include APIOperations::Delete
+    def self.resource_path(id = nil)
+      return "reports/batch_mdr_reports/#{CGI.escape(id)}" if id
+
+      "reports/batch_mdr_reports"
+    end
+    OBJECT_NAME = "/reports/batch_mdr_report".freeze
+  end
+end

data/lib/telnyx/brand.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class Brand < APIResource
+    extend APIOperations::List
+    extend APIOperations::Create
+    extend APIOperations::NestedResource
+    include APIOperations::Delete
+    include APIOperations::Save
+
+    OBJECT_NAME = "10dlc/brand".freeze
+  end
+end

data/lib/telnyx/bulk_creation.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class BulkCreation < APIResource
+    extend Telnyx::APIOperations::List
+    extend Telnyx::APIOperations::Create
+    include Telnyx::APIOperations::Delete
+    include Telnyx::APIOperations::Save
+    extend APIOperations::NestedResource
+
+    ACTIONS = %w[detailedStatus].freeze
+    ACTIONS.each do |action|
+      nested_resource_class_methods action,
+                                    path: %W[#{action}],
+                                    operations: [:create],
+                                    instance_methods: { create: action }
+    end
+
+    OBJECT_NAME = "10dlc/bulkCreation".freeze
+  end
+end

data/lib/telnyx/bulk_credential.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class BulkCredential < APIResource
+    def self.bulk_telephony_credentials(params = {}, opts = {})
+      resp, opts = request(:post, "/v2/actions/bulk/telephony_credentials", params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
+
+    def self.purchase_esims(params = {}, opts = {})
+      resp, opts = request(:post, "/v2/actions/purchase/esims", params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
+    OBJECT_NAME = "action".freeze
+  end
+end

data/lib/telnyx/bulk_sim_card_action.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class BulkSimCardAction < APIResource
+    extend Telnyx::APIOperations::List
+
+    OBJECT_NAME = "bulk_sim_card_action".freeze
+  end
+end

data/lib/telnyx/business_identitie.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class BusinessIdentitie < APIResource
+    extend APIOperations::List
+
+    OBJECT_NAME = "business_identitie".freeze
+  end
+end

data/lib/telnyx/call.rb

@@ -31,11 +31,11 @@ module Telnyx
       end
     end
 
-    ACTIONS = %w[reject answer hangup bridge speak fork_start fork_stop
+    ACTIONS = %w[reject answer client_state_update hangup bridge speak fork_start fork_stop
                  gather_using_audio gather_using_speak playback_start
                  playback_stop record_start record_stop send_dtmf transfer
                  transcription_start transcription_stop record_pause
-                 record_resume gather_stop refer enqueue leave_queue].freeze
+                 record_resume register gather_stop refer enqueue leave_queue streaming_start streaming_stop gather].freeze
 
     ACTIONS.each do |action|
       nested_resource_class_methods action,

data/lib/telnyx/call_event.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class CallEvent < APIResource
+    extend APIOperations::List
+
+    OBJECT_NAME = "call_event".freeze
+  end
+end

data/lib/telnyx/call_recording.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class CallRecording < APIResource
+    extend APIOperations::List
+    extend APIOperations::Create
+    include APIOperations::Delete
+    include APIOperations::Save
+
+    OBJECT_NAME = "recording".freeze
+  end
+end

data/lib/telnyx/campaign.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class Campaign < APIResource
+    extend Telnyx::APIOperations::List
+    extend Telnyx::APIOperations::Create
+    include Telnyx::APIOperations::Delete
+    include Telnyx::APIOperations::Save
+    extend APIOperations::NestedResource
+
+    ACTIONS = %w[mnoMetadata operationStatus].freeze
+    ACTIONS.each do |action|
+      nested_resource_class_methods action,
+                                    path: %W[#{action}],
+                                    operations: [:create],
+                                    instance_methods: { create: action }
+    end
+    def accept_sharing(params = {}, opts = {})
+      resp, opts = request(:post, "/v2/campaign/acceptSharing/#{campaignId.gsub(/\s+/, '+')}", params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
+
+    def sharing(params = {}, opts = {})
+      resp, opts = request(:get, "/v2/campaign/#{campaignId.gsub(/\s+/, '+')}/sharing", params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
+
+    def osr_attributes(params = {}, opts = {})
+      resp, opts = request(:get, "/v2/campaign/#{campaignId.gsub(/\s+/, '+')}/osr/attributes", params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
+    OBJECT_NAME = "campaign".freeze
+  end
+end

data/lib/telnyx/cdr_usage_report.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class CdrUsageReport < APIResource
+    def self.sync(params = {}, opts = {})
+      opts = Util.normalize_opts(opts)
+      resp, opts = request(:get, "/v2/reports/cdr_usage_reports/sync", params, opts)
+      ListObject.construct_from(resp.data, opts)
+    end
+
+    OBJECT_NAME = "/reports/cdr_usage_report".freeze
+  end
+end

data/lib/telnyx/channel_zone.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class ChannelZone < APIResource
+    extend APIOperations::List
+    extend APIOperations::NestedResource
+    include APIOperations::Save
+    OBJECT_NAME = "channel_zone".freeze
+  end
+end

data/lib/telnyx/comment.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class Comment < APIResource
+    extend Telnyx::APIOperations::List
+    extend Telnyx::APIOperations::Create
+    extend APIOperations::NestedResource
+
+    nested_resource_class_methods "read",
+                                  path: "read",
+                                  operations: [:update],
+                                  instance_methods: { update: "read" }
+
+    def read(opts = nil)
+      self.class.update_read(id, nil, opts)
+    end
+
+    OBJECT_NAME = "comment".freeze
+  end
+end

data/lib/telnyx/conference.rb

@@ -6,7 +6,7 @@ module Telnyx
     extend APIOperations::Create
     extend APIOperations::NestedResource
 
-    ACTIONS = %w[join mute unmute hold unhold speak play dial_participant update].freeze
+    ACTIONS = %w[join mute unmute hold unhold leave speak stop play dial_participant update record_pause record_resume].freeze
 
     ACTIONS.each do |action|
       nested_resource_class_methods action,

data/lib/telnyx/connection.rb

@@ -3,6 +3,11 @@
 module Telnyx
   class Connection < APIResource
     extend Telnyx::APIOperations::List
+    extend APIOperations::NestedResource
+    nested_resource_class_methods :active_calls,
+                                  path: ["active_calls"],
+                                  operations: %i[list],
+                                  instance_methods: { list: "active_calls" }
 
     OBJECT_NAME = "connection".freeze
   end

data/lib/telnyx/csv_download.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class CsvDownload < APIResource
+    extend Telnyx::APIOperations::List
+    extend Telnyx::APIOperations::Create
+
+    OBJECT_NAME = "phone_numbers/csv_download".freeze
+  end
+end

data/lib/telnyx/custom_storage_credential.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class CustomStorageCredential < APIResource
+    OBJECT_NAME = "custom_storage_credential".freeze
+  end
+end

data/lib/telnyx/detail_record.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class DetailRecord < APIResource
+    extend APIOperations::List
+
+    OBJECT_NAME = "detail_record".freeze
+  end
+end

data/lib/telnyx/dialogflow_connection.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class DialogflowConnection < APIResource
+    extend Telnyx::APIOperations::Create
+    include Telnyx::APIOperations::Delete
+    include Telnyx::APIOperations::Save
+
+    OBJECT_NAME = "dialogflow_connection".freeze
+    def self.create(params = {}, opts = {})
+      if opts.respond_to? :fetch
+        url = opts.fetch(:resource_url, nil)
+        opts.delete :resource_url
+      end
+      url ||= resource_url
+      resp, opts = request(:post, "#{url}/#{params[:connection_id]}", params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
+  end
+end

data/lib/telnyx/document.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class Documents < APIResource
+    extend Telnyx::APIOperations::List
+    extend Telnyx::APIOperations::Create
+    include Telnyx::APIOperations::Delete
+    include Telnyx::APIOperations::Save
+    extend APIOperations::NestedResource
+
+    ACTIONS = %w[download document_links].freeze
+    ACTIONS.each do |action|
+      nested_resource_class_methods action,
+                                    path: %W[#{action}],
+                                    operations: [:create],
+                                    instance_methods: { create: action }
+    end
+    OBJECT_NAME = "document".freeze
+  end
+end

data/lib/telnyx/dynamic_emergency_address.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class ManagedAccount < APIResource
+    extend Telnyx::APIOperations::List
+    extend Telnyx::APIOperations::Create
+    include Telnyx::APIOperations::Delete
+    include Telnyx::APIOperations::Save
+
+    OBJECT_NAME = "managed_account".freeze
+  end
+end

data/lib/telnyx/dynamic_emergency_endpoint.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class DynamicEmergencyEndpoint < APIResource
+    extend Telnyx::APIOperations::List
+    extend Telnyx::APIOperations::Create
+    include Telnyx::APIOperations::Delete
+    include Telnyx::APIOperations::Save
+
+    OBJECT_NAME = "dynamic_emergency_endpoint".freeze
+  end
+end

data/lib/telnyx/embedding.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class Embedding < APIResource
+    extend APIOperations::Create
+
+    def self.buckets(params = {}, opts = {})
+      resp, opts = request(:get, "/v2/ai/embeddings/buckets", params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
+
+    OBJECT_NAME = "ai/embedding".freeze
+  end
+end

data/lib/telnyx/enum.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class Enum < APIResource
+    extend APIOperations::List
+    extend APIOperations::NestedResource
+
+    def self.endpoint(params = {}, opts = {})
+      resp, opts = request(:get, "/v2/enum/#{params[:endpoint]}", params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
+
+    OBJECT_NAME = "enum".freeze
+  end
+end

data/lib/telnyx/fax.rb

@@ -6,8 +6,22 @@ module Telnyx
     extend Telnyx::APIOperations::Create
     include Telnyx::APIOperations::Delete
     include Telnyx::APIOperations::Save
+    extend APIOperations::NestedResource
+
+    ACTIONS = %w[refresh cancel].freeze
+    ACTIONS.each do |action|
+      nested_resource_class_methods action,
+                                    path: %W[actions #{action}],
+                                    operations: [:create],
+                                    instance_methods: { create: action }
+    end
 
     OBJECT_NAME = "fax".freeze
     RESOURCE_PATH = "faxes".freeze
+    def self.retrieve(id, opts = {})
+      id, retrieve_params = Util.normalize_id(id)
+      resp, opts = request(:get, "#{resource_url}/#{CGI.escape(id)}", retrieve_params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
   end
 end

data/lib/telnyx/global_ip.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class GlobalIp < APIResource
+    extend Telnyx::APIOperations::List
+    extend Telnyx::APIOperations::Create
+    include Telnyx::APIOperations::Delete
+    OBJECT_NAME = "global_ip".freeze
+  end
+end

data/lib/telnyx/global_ip_allowed_port.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class GlobalIpAllowedPort < APIResource
+    extend Telnyx::APIOperations::List
+    OBJECT_NAME = "global_ip_allowed_port".freeze
+  end
+end

data/lib/telnyx/global_ip_assignment.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class GlobalIpAssignment < APIResource
+    extend APIOperations::List
+    extend APIOperations::Create
+    include APIOperations::Delete
+    include APIOperations::Save
+
+    OBJECT_NAME = "global_ip_assignment".freeze
+  end
+end

data/lib/telnyx/global_ip_assignment_health.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class GlobalIpAssignmentHealth < APIResource
+    extend Telnyx::APIOperations::List
+    OBJECT_NAME = "global_ip_assignment_health".freeze
+  end
+end

data/lib/telnyx/global_ip_assignment_usage.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class GlobalIpAssignmentUsage < APIResource
+    extend Telnyx::APIOperations::List
+    OBJECT_NAME = "global_ip_assignment_usage".freeze
+  end
+end

data/lib/telnyx/global_ip_latency.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class GlobalIpLatency < APIResource
+    extend Telnyx::APIOperations::List
+    OBJECT_NAME = "global_ip_latency".freeze
+  end
+end

data/lib/telnyx/global_ip_protocol.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class GlobalIpProtocol < APIResource
+    extend Telnyx::APIOperations::List
+    OBJECT_NAME = "global_ip_protocol".freeze
+  end
+end

data/lib/telnyx/global_ip_usage.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class GlobalIpUsage < APIResource
+    extend Telnyx::APIOperations::List
+    OBJECT_NAME = "global_ip_usage".freeze
+  end
+end

data/lib/telnyx/inference.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class Inference < APIResource
+    extend Telnyx::APIOperations::Create
+
+    OBJECT_NAME = "ai/generate".freeze
+  end
+end

data/lib/telnyx/inventory_coverage.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class InventoryCoverage < APIResource
+    extend Telnyx::APIOperations::Create
+
+    OBJECT_NAME = "inventory_coverage".freeze
+  end
+end

data/lib/telnyx/ledger_billing_group_report.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class LedgerBillingGroupReport < APIResource
+    extend APIOperations::Create
+
+    OBJECT_NAME = "ledger_billing_group_report".freeze
+  end
+end

data/lib/telnyx/managed_account.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Telnyx
+  class ManagedAccount < APIResource
+    extend APIOperations::List
+    extend APIOperations::Create
+    extend APIOperations::NestedResource
+    include APIOperations::Delete
+    include APIOperations::Save
+
+    ACTIONS = %w[enable disable].freeze
+    ACTIONS.each do |action|
+      nested_resource_class_methods action,
+                                    path: %W[actions #{action}],
+                                    operations: [:create],
+                                    instance_methods: { create: action }
+    end
+    nested_resource_class_methods "update_global_channel_limit",
+                                  path: "update_global_channel_limit",
+                                  operations: [:update],
+                                  instance_methods: { update: "update_global_channel_limit" }
+    def self.allocatable_global_outbound_channels(params = {}, opts = {})
+      resp, opts = request(:get, "/v2/managed_accounts/allocatable_global_outbound_channels", params, opts)
+      Util.convert_to_telnyx_object(resp.data, opts)
+    end
+
+    def update_global_channel_limit(opts)
+      self.class.update_update_global_channel_limit(id, nil, opts)
+    end
+    OBJECT_NAME = "managed_account".freeze
+  end
+end