voiceml 0.9.1 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f65ec54117bee65194bbf24028d00c20d820cee04cc9200472a42b329cd942f8
-  data.tar.gz: 3e2104d7267e31948f3160b37e527cec42acf4a68cb366b4963435f71e55f8ca
+  metadata.gz: 758b40e32d36539e838ab6418d8a978b089ebfebc7754847049e47fb281e4336
+  data.tar.gz: 057dc821a03507d3883edc839e9e5e2ead794e162cef2ff76ea6bf1d6f9787d6
 SHA512:
-  metadata.gz: dbbe6c38b68861d43ed68d7d3ffa335fb9caf7582fa47b091ca37e29ed3fda725f3b492aab06501c7a61d686c2db1e123fa0fd75e5440ed407a4304646feb19a
-  data.tar.gz: '09ced634a9e275031687a7d3647795a4c7a287928a8da4ffe5f61babd10c86eee840890e5233552e64ddf4aa68a50319ef42cd2a37afe68975d87cddb16dbe69'
+  metadata.gz: d88a3dc916f95b965f0899f910a0fee987d85b9d81ee33dc2dec8ce9b3d71178209e7c07999fb599d76cf172ad620b84d144459e2d3cb9ecde7e9a87e2a60dc1
+  data.tar.gz: 9aa62aaa635a1e2021ded627867cc6954eb389c16732c67ab9470fad749a6acbe64f448b7bd92dae412798196d024022d83c33ce0203f6718d0158330da8f5d5

data/README.md

@@ -1,11 +1,11 @@
 # 📞 VoiceML Ruby SDK
 
-The official Ruby client for the [VoiceML REST API](https://voicetel.com/docs/api/v0.8/voiceml/) — Twilio-compatible outbound voice and answering-machine-detection from VoiceTel, with idiomatic snake_case kwargs, structured errors, and a Twilio-compatible wire format.
+The official Ruby client for the [VoiceML REST API](https://voicetel.com/docs/api/v0.9/voiceml/) — Twilio-compatible outbound voice and answering-machine-detection from VoiceTel, with idiomatic snake_case kwargs, structured errors, and a Twilio-compatible wire format.
 
-![Version](https://img.shields.io/badge/version-0.9.1-blue)
-![Ruby](https://img.shields.io/badge/ruby-3.0%2B-red)
+![Version](https://img.shields.io/badge/version-0.9.3-blue)
+![Ruby](https://img.shields.io/badge/ruby-3.1%2B-red)
 ![License](https://img.shields.io/badge/license-MIT-green)
-![Tests](https://img.shields.io/badge/tests-65%20specs-brightgreen)
+![Tests](https://img.shields.io/badge/tests-227%20examples-brightgreen)
 ![Gem](https://img.shields.io/badge/gem-voiceml-blue)
 
 ## 📚 Table of Contents
@@ -44,15 +44,22 @@ The official Ruby client for the [VoiceML REST API](https://voicetel.com/docs/ap
 - **Queues** — create, list, update, delete, peek, dequeue (front or specific member).
 - **Applications** — CRUD on stored TwiML + callback bundles.
 - **Recordings** — account-wide list, metadata fetch, audio fetch (follows S3 redirect), delete.
-- **Messages** — create, fetch, list (To/From/DateSent filters + pagination), update (Body redaction; Status=canceled), delete.
+- **Messages** — create, fetch, list (To/From/DateSent filters + pagination), update (Body redaction; Status=canceled), delete, delivery feedback (`create_feedback`).
 - **IncomingPhoneNumbers** — list, fetch, update.
 - **Notifications** — fetch, list.
+- **Monitor Alerts** — `client.monitor_alerts` list (severity + date-window filters) and fetch over the `/v1` `meta` envelope.
+- **Accounts** — `client.accounts.fetch` / `update` / `fetch_balance` / `rotate_key` (key rotation returns the new key on `AccountWithKey#api_key`).
 - **SIP** — SIP Trunking: Domains (CRUD), CredentialLists + Credentials (CRUD), IpAccessControlLists + IpAddresses (CRUD), Domain↔ACL/CredentialList mappings (historical, Auth/Calls, Auth/Registrations namespaces).
 - **Routes V2** — Twilio Inbound Processing Region API: `client.routes_v2.sip_domains.fetch(name)` / `update(name, voice_region:, friendly_name:)`.
+- **Messaging Service** — `client.messaging_v1.services` CRUD (`MG...` services), routed automatically at the `messaging.voicetel.com` product host.
+- **Pricing** — read-only `client.pricing.v1` / `client.pricing.v2` for Voice, Messaging, PhoneNumbers, and Trunking country + number lookups.
 - **Diagnostics** — `/health` deep probe, OpenAPI spec.
 
+### 🌐 Per-product hosts
+VoiceML mirrors Twilio's product-per-subdomain model. The whole `conversations_v1` group is routed to `conversations.voicetel.com` and `messaging_v1` to `messaging.voicetel.com`, while everything else stays on the default `voiceml.voicetel.com`. These hosts are derived automatically from `base_url`; a non-`voicetel.com` base (e.g. a self-hosted instance) keeps every product on that single host. Override per product with `messaging_base_url:` / `conversations_base_url:` on the client constructor.
+
 ### 🧪 Tested
-- **81 specs** with mocked HTTP layer (`webmock`) covering every resource and pagination edge cases — spec drift gets caught at parse time.
+- **227 examples** with mocked HTTP layer (`webmock`) covering every resource and pagination edge cases — spec drift gets caught at parse time.
 - Integration smoke spec gated by env vars — safe for CI.
 
 ### 📦 Clean Distribution
@@ -72,7 +79,7 @@ Or in your `Gemfile`:
 gem 'voiceml', '~> 0.7'
 ```
 
-Requires Ruby 3.0 or later.
+Requires Ruby 3.1 or later.
 
 ## 🏁 Quickstart
 
@@ -85,8 +92,8 @@ client = VoiceML::Client.new(
 )
 
 call = client.calls.create(
-  to:                '+18005551234',
-  from:              '+18005550000',
+  to:                '+14155550100',
+  from:              '+14155550101',
   url:               'https://example.com/twiml',
   machine_detection: 'DetectMessageEnd'
 )
@@ -100,7 +107,7 @@ end
 
 ## 🔑 Authentication
 
-Every endpoint uses **HTTP Basic** with your `AccountSid` as the username and your per-tenant API key as the password — identical to Twilio's auth shape, so credentials issued for Twilio code work here unchanged.
+Every endpoint uses **HTTP Basic** with your `AccountSid` as the username and your per-tenant API key as the password — the same positions Twilio SDKs use, so existing credential-passing code migrates unchanged. VoiceML issues its own credentials; Twilio-issued credentials do not work here.
 
 - **Username** = your `AccountSid` (Twilio-format `AC` + 32 hex chars).
 - **Password** = your per-tenant API key (pass as `api_key:` or, for migration-compatible drop-in, `auth_token:`).
@@ -110,7 +117,7 @@ client = VoiceML::Client.new(account_sid: 'AC...', api_key: '...')
 client.diagnostics.health  # uses your AccountSid + key on every call
 ```
 
-> Don't have credentials yet? See **[voicetel.com/docs/api/v0.8/voiceml/](https://voicetel.com/docs/api/v0.8/voiceml/)** for issuance and rotation.
+> Don't have credentials yet? See **[voicetel.com/docs/api/v0.9/voiceml/](https://voicetel.com/docs/api/v0.9/voiceml/)** for issuance and rotation.
 
 ## 🗺️ Resource Reference
 
@@ -121,9 +128,13 @@ client.diagnostics.health  # uses your AccountSid + key on every call
 | `client.queues` | create, list, update, delete | peek, dequeue (front or specific member) |
 | `client.applications` | CRUD on TwiML + callback bundles | |
 | `client.recordings` | account-wide list, metadata, audio fetch, delete | follows S3 redirect for audio |
-| `client.messages` | create, fetch, list, update, delete | To/From/DateSent filters; Body redaction; Status=canceled |
+| `client.messages` | create, fetch, list, update, delete, create_feedback | To/From/DateSent filters; Body redaction; Status=canceled; delivery feedback |
 | `client.incoming_phone_numbers` | list, fetch, update | |
 | `client.notifications` | fetch, list | |
+| `client.monitor_alerts` | list, fetch | Monitor v1 Alerts (`/v1` `meta` envelope); severity + date-window filters |
+| `client.accounts` | fetch, update, fetch_balance, rotate_key | rotate_key returns the new API key on `AccountWithKey#api_key` |
+| `client.messaging_v1.services` | create, list, fetch, update, delete | Messaging Service (`MG...`); routed at `messaging.voicetel.com` |
+| `client.pricing.v1` / `.v2` | countries.list / fetch, numbers.fetch | Voice, Messaging, PhoneNumbers, Trunking (read-only, default host) |
 | `client.diagnostics` | `/health`, OpenAPI spec | |
 
 Methods accept idiomatic snake_case keyword arguments — they're translated to Twilio's PascalCase wire field names internally:
@@ -132,8 +143,8 @@ Methods accept idiomatic snake_case keyword arguments — they're translated to
 client = VoiceML::Client.new(account_sid: 'AC...', api_key: '...')
 
 call = client.calls.create(
-  to:   '+18005551234',
-  from: '+18005550000',
+  to:   '+14155550100',
+  from: '+14155550101',
   url:  'https://example.com/twiml'
 )
 
@@ -188,7 +199,7 @@ client.calls.each(status: 'completed', page_size: 200) do |call|
 end
 
 # Enumerator form — chain with Enumerable methods
-recent = client.messages.each(from: '+18005550000', page_size: 200).first(50)
+recent = client.messages.each(from: '+14155550101', page_size: 200).first(50)
 
 client.queues.each do |q|
   archive(q) if q.current_size.zero?
@@ -245,7 +256,7 @@ gem build voiceml.gemspec
 
 ## 📖 API Documentation
 
-- **Reference docs:** [voicetel.com/docs/api/v0.8/voiceml/](https://voicetel.com/docs/api/v0.8/voiceml/)
+- **Reference docs:** [voicetel.com/docs/api/v0.9/voiceml/](https://voicetel.com/docs/api/v0.9/voiceml/)
 - **Validator:** [voicetel.com/voiceml/validator/](https://voicetel.com/voiceml/validator/)
 - **SDK catalogue:** [voicetel.com/docs/voiceml-sdks/](https://voicetel.com/docs/voiceml-sdks/)
 - **YARD comments:** every resource method carries `@param` / `@return` docs — `yard doc lib` builds them locally.

data/lib/voiceml/client.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'transport'
+require_relative 'hosts'
 require_relative 'resources/calls'
 require_relative 'resources/conferences'
 require_relative 'resources/queues'
@@ -15,42 +16,73 @@ require_relative 'resources/routes_v2'
 require_relative 'resources/voice_v1'
 require_relative 'resources/conversations_v1'
 require_relative 'resources/assistants_v1'
+require_relative 'resources/messaging_v1'
+require_relative 'resources/pricing'
+require_relative 'resources/accounts'
+require_relative 'resources/outgoing_caller_ids'
+require_relative 'resources/exports'
+require_relative 'resources/usage_records'
+require_relative 'resources/transcriptions'
+require_relative 'resources/monitor_v1'
 
 module VoiceML
   # Synchronous client for the VoiceML REST API.
   #
   # VoiceML uses HTTP Basic auth: the `account_sid` (Twilio-format `AC` + 32 hex) is the
-  # username and `api_key` is the password. Drop-in compatible with the Twilio Ruby SDK
-  # constructor signature.
+  # username and `api_key` is the password, in the same HTTP Basic positions twilio-ruby
+  # uses. VoiceML issues its own credentials — the AccountSid plus a VoiceML API key;
+  # Twilio-issued credentials do not work here.
+  #
+  # A client without an `api_key:` is a credential-less diagnostics client: only
+  # {VoiceML::DiagnosticsResource} calls work (the spec marks them `security: []`);
+  # anything authenticated raises {VoiceML::ConfigurationError}.
+  #
+  # The client is thread-safe: requests may be issued from any number of threads,
+  # each holding its own connection per host.
   #
   # @example
   #   client = VoiceML::Client.new(account_sid: 'AC...', api_key: '...')
   #   call = client.calls.create(
-  #     to: '+18005551234',
-  #     from: '+18005550000',
-  #     url: 'https://example.com/twiml'
+  #     to: '+14155550100',
+  #     from: '+14155550101',
+  #     url: 'https://example.com/handler'
   #   )
   #   puts call.sid, call.status
   class Client
     attr_reader :calls, :conferences, :queues, :applications, :recordings,
                 :incoming_phone_numbers, :notifications, :diagnostics, :messages,
-                :sip, :routes_v2, :voice_v1, :conversations_v1, :assistants_v1
+                :sip, :routes_v2, :voice_v1, :conversations_v1, :assistants_v1,
+                :messaging_v1, :pricing, :accounts, :outgoing_caller_ids, :exports,
+                :usage_records, :transcriptions, :monitor_alerts
 
     # @param account_sid [String] Twilio-format AccountSid (`AC` + 32 hex).
-    # @param api_key     [String, nil] per-tenant API key. Pass either `api_key:` or the
-    #   Twilio-compatible alias `auth_token:` (not both — `ArgumentError` if you do).
-    # @param auth_token  [String, nil] Twilio-compatible alias for `api_key`. Lets twilio-ruby
-    #   code (`VoiceML::Client.new(account_sid: sid, auth_token: token)`) work unchanged.
+    # @param api_key     [String, nil] per-tenant VoiceML API key. Pass either `api_key:` or
+    #   the Twilio-compatible alias `auth_token:` (not both — `ArgumentError` if you do).
+    #   Omit both for a credential-less diagnostics-only client.
+    # @param auth_token  [String, nil] Twilio-compatible alias for `api_key`. Lets
+    #   credential-passing code written for twilio-ruby keep its call shape; the key
+    #   itself must be a VoiceML API key.
     # @param base_url    [String] server base URL. Defaults to `https://voiceml.voicetel.com`.
-    # @param timeout     [Numeric] per-request timeout in seconds. Defaults to 30.
-    # @param max_retries [Integer] retry attempts for 429/5xx and transport errors. Defaults to 2.
+    # @param timeout     [Numeric] per-request connect/read/write timeout in seconds. Defaults to 30.
+    # @param max_retries [Integer] retry attempts. Idempotent requests (GET/HEAD/PUT/DELETE)
+    #   retry on 429/5xx and transport errors; POST/PATCH retry only on 429 and
+    #   connect-phase failures. Defaults to 2.
     # @param user_agent  [String, nil] override the `User-Agent` header. Defaults to
     #   `"voiceml-ruby/#{VERSION}"`.
-    def initialize(account_sid:, api_key: nil, auth_token: nil,
+    # @param http_client [Net::HTTP, #call, nil] a `Net::HTTP` used for its own host, or a
+    #   factory `->(uri) { Net::HTTP.new(uri.host, uri.port) }` supplying every
+    #   connection. Caller-supplied connections are never finished by the SDK; hosts the
+    #   object/factory does not cover fall back to SDK-managed connections.
+    # @param messaging_base_url     [String, nil] override the host for `messaging_v1`. Defaults to
+    #   the `messaging.*.voicetel.com` subdomain derived from `base_url` (else `base_url` itself).
+    # @param conversations_base_url [String, nil] override the host for `conversations_v1`. Defaults
+    #   to the `conversations.*.voicetel.com` subdomain derived from `base_url` (else `base_url`).
+    def initialize(account_sid: nil, api_key: nil, auth_token: nil,
                    base_url: Transport::DEFAULT_BASE_URL,
                    timeout: Transport::DEFAULT_TIMEOUT,
                    max_retries: Transport::DEFAULT_MAX_RETRIES,
-                   user_agent: nil, http_client: nil)
+                   user_agent: nil, http_client: nil,
+                   messaging_base_url: nil, conversations_base_url: nil)
       if !api_key.nil? && !auth_token.nil?
         raise ArgumentError, 'pass either api_key: or auth_token:, not both'
       end
@@ -67,6 +99,16 @@ module VoiceML
         http_client: http_client
       )
 
+      # VoiceML mirrors Twilio's product-per-subdomain model: the whole Conversations group
+      # rides `conversations.voicetel.com` and Messaging Service rides `messaging.voicetel.com`,
+      # while everything else stays on the default host. See VoiceML::Hosts.
+      _default, messaging_host, conversations_host =
+        Hosts.resolve_product_base_urls(base_url,
+                                        messaging_base_url: messaging_base_url,
+                                        conversations_base_url: conversations_base_url)
+      messaging_transport     = ScopedTransport.new(@transport, messaging_host)
+      conversations_transport = ScopedTransport.new(@transport, conversations_host)
+
       @calls                  = CallsResource.new(@transport)
       @conferences            = ConferencesResource.new(@transport)
       @queues                 = QueuesResource.new(@transport)
@@ -79,8 +121,16 @@ module VoiceML
       @sip                    = SipResource.new(@transport)
       @routes_v2              = RoutesV2Resource.new(@transport)
       @voice_v1               = VoiceV1Resource.new(@transport)
-      @conversations_v1       = ConversationsV1Resource.new(@transport)
+      @conversations_v1       = ConversationsV1Resource.new(conversations_transport)
       @assistants_v1          = AssistantsV1Resource.new(@transport)
+      @messaging_v1           = MessagingV1Resource.new(messaging_transport)
+      @pricing                = PricingResource.new(@transport)
+      @accounts               = AccountsResource.new(@transport)
+      @outgoing_caller_ids    = OutgoingCallerIdsResource.new(@transport)
+      @exports                = ExportsResource.new(@transport)
+      @usage_records          = UsageRecordsResource.new(@transport)
+      @transcriptions         = TranscriptionsResource.new(@transport)
+      @monitor_alerts         = MonitorAlertsResource.new(@transport)
     end
 
     def account_sid
@@ -90,5 +140,16 @@ module VoiceML
     def base_url
       @transport.base_url
     end
+
+    # Close SDK-managed idle connections. The client remains usable.
+    def close
+      @transport.close
+    end
+
+    # A redacted dump: never includes the API key.
+    def inspect
+      "#<#{self.class.name} account_sid=#{account_sid} base_url=#{base_url}>"
+    end
+    alias to_s inspect
   end
 end

data/lib/voiceml/errors.rb

@@ -43,12 +43,25 @@ module VoiceML
   # HTTP 410 — recording audio is no longer available (no local file, no S3 key).
   class GoneError < ApiError; end
 
-  # HTTP 429 — per-account rate limit exceeded.
-  class RateLimitError < ApiError; end
+  # HTTP 429 — per-account rate limit exceeded. When the server sends a
+  # `Retry-After` header, the parsed delay in seconds is exposed on
+  # `#retry_after`.
+  class RateLimitError < ApiError
+    attr_reader :retry_after
+
+    def retry_after=(seconds)
+      @retry_after = seconds
+    end
+  end
 
   # HTTP 501 — endpoint is mounted as a stub (e.g. UserDefinedMessages).
   class NotImplementedAPIError < ApiError; end
 
+  # The request could not be delivered: connection failures, TLS errors,
+  # timeouts, malformed or refused redirects. The original exception is
+  # preserved as `#cause`.
+  class ConnectionError < ApiError; end
+
   # HTTP 5xx — the server hit an error processing the request.
   class ServerError < ApiError; end
 

data/lib/voiceml/hosts.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+require_relative 'transport'
+
+module VoiceML
+  # Per-product host resolution for the VoiceML API.
+  #
+  # Twilio splits its products across dedicated subdomains (`api.twilio.com`,
+  # `conversations.twilio.com`, `messaging.twilio.com`, ...). VoiceML mirrors that
+  # shape on `voicetel.com`: the Conversations product answers on
+  # `conversations.voicetel.com` and the Messaging Service product on
+  # `messaging.voicetel.com`, while everything else stays on the default
+  # `voiceml.voicetel.com` host. Conversation Service and Messaging Service share
+  # the identical `/v1/Services` path shape, so the *host* is what disambiguates
+  # them on the wire.
+  #
+  # Given the configured `base_url` this module derives the two product hosts by
+  # swapping the leftmost `voiceml` label — but only for recognised
+  # `*.voicetel.com` hosts. For any other base URL (a self-hosted callBroadcast
+  # instance, a test stub, a regional override) the product hosts fall back to the
+  # configured host unchanged, so a single-host deployment keeps working. A caller
+  # who needs Messaging Service against a custom host points `messaging_base_url`
+  # (or `conversations_base_url`) at their own subdomain explicitly.
+  module Hosts
+    module_function
+
+    # Swap the `voiceml` label of a `*.voicetel.com` host for `product`.
+    #
+    # Returns `base_url` unchanged when the host is not a `voiceml.*.voicetel.com`
+    # style host (e.g. a self-hosted instance), so single-host deployments keep
+    # working without special-casing.
+    def derive_product_host(base_url, product)
+      uri = URI.parse(base_url)
+      host = uri.host
+      return base_url if host.nil? || !host.end_with?('.voicetel.com')
+
+      labels = host.split('.')
+      idx = labels.index('voiceml')
+      return base_url if idx.nil?
+
+      labels[idx] = product
+      uri.host = labels.join('.')
+      uri.query = nil
+      uri.fragment = nil
+      uri.to_s
+    end
+
+    # Return `[default, messaging, conversations]` base URLs.
+    #
+    # Explicit overrides win; otherwise each product host is derived from
+    # `base_url` (see module docstring). All three are returned without a
+    # trailing slash.
+    def resolve_product_base_urls(base_url, messaging_base_url: nil, conversations_base_url: nil)
+      default       = Transport.strip_trailing_slashes(base_url)
+      messaging     = Transport.strip_trailing_slashes(messaging_base_url || derive_product_host(default, 'messaging'))
+      conversations = Transport.strip_trailing_slashes(conversations_base_url || derive_product_host(default, 'conversations'))
+      [default, messaging, conversations]
+    end
+  end
+end

data/lib/voiceml/models/accounts.rb

@@ -6,17 +6,18 @@ module VoiceML
   # Twilio-compatible Account resource. The voiceml SDK is single-account
   # (the credential's account is implicit on every call), so this model
   # exists primarily to decode `GET/POST /Accounts/{Sid}.json` responses
-  # round-trip with the Twilio shape — useful for migration tooling that
-  # echoes the account record back to the caller.
+  # in the Twilio-compatible wire format — useful for migration tooling
+  # that echoes the account record back to the caller.
   class Account
     ATTRIBUTES = %w[
-      sid friendly_name status type auth_token owner_account_sid
+      sid friendly_name status type owner_account_sid
       date_created date_updated subresource_uris uri
     ].freeze
 
     attr_reader(*ATTRIBUTES.map(&:to_sym))
 
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each do |field|
         value = attrs.key?(field) ? attrs[field] : attrs[field.to_sym]
         instance_variable_set("@#{field}", value)
@@ -34,11 +35,13 @@ module VoiceML
   # the account's settlement currency. No `sid` field on the wire (the
   # balance is account-scoped, not its own resource).
   class Balance
+    include RawAttributes
     ATTRIBUTES = %w[account_sid balance currency].freeze
 
     attr_reader(*ATTRIBUTES.map(&:to_sym))
 
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each do |field|
         value = attrs.key?(field) ? attrs[field] : attrs[field.to_sym]
         instance_variable_set("@#{field}", value)
@@ -51,4 +54,45 @@ module VoiceML
       new(hash)
     end
   end
+
+  # `POST /Accounts/{Sid}/RotateKey` response — the account configuration
+  # view plus the freshly generated `api_key`. No read endpoint returns the
+  # key, so store it right away; requests signed with the previous key fail
+  # with 401 from that point on. The key is secret material and never
+  # appears in `inspect` / `to_s` output.
+  class AccountWithKey
+    include RawAttributes
+    ATTRIBUTES = %w[
+      sid api_key sip_username name phone_regions allow_cidr disabled
+      stt_fs_vendor stt_http_url stt_http_token_set tts_http_url
+      tts_http_token_set tts_engine_name tts_default_voice tts_default_language
+      stripe_secret_key_set pay_enabled sms_provider sms_allowed_providers
+      stt_allowed_providers stt_provider voice_url voice_method
+      voice_fallback_url voice_fallback_method aws_bucket aws_region
+      aws_prefix aws_access_key_id aws_secret_access_key_set aws_kms_key_id
+      created_at updated_at
+    ].freeze
+
+    attr_reader(*ATTRIBUTES.map(&:to_sym))
+
+    def initialize(attrs = {})
+      @raw_attributes = attrs
+      ATTRIBUTES.each do |field|
+        value = attrs.key?(field) ? attrs[field] : attrs[field.to_sym]
+        instance_variable_set("@#{field}", value)
+      end
+    end
+
+    def self.from_hash(hash)
+      return nil if hash.nil?
+
+      new(hash)
+    end
+
+    # A redacted dump: never includes the api_key.
+    def inspect
+      "#<#{self.class.name} sid=#{@sid}>"
+    end
+    alias to_s inspect
+  end
 end

data/lib/voiceml/models/applications.rb

@@ -5,16 +5,20 @@ require_relative 'common'
 module VoiceML
   # Persistent TwiML+callback bundle dispatched by `<Dial><Application>`.
   class Application
+    include RawAttributes
     ATTRIBUTES = %w[
       sid account_sid friendly_name api_version voice_url voice_method
       voice_fallback_url voice_fallback_method voice_caller_id_lookup
       status_callback status_callback_method status_callback_event
+      message_status_callback sms_status_callback
+      sms_url sms_method sms_fallback_url sms_fallback_method
       date_created date_updated uri
     ].freeze
 
     attr_reader(*ATTRIBUTES.map(&:to_sym))
 
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each do |field|
         value = attrs.key?(field) ? attrs[field] : attrs[field.to_sym]
         instance_variable_set("@#{field}", value)
@@ -30,11 +34,13 @@ module VoiceML
 
   # Paginated `GET /Applications` response.
   class ApplicationList
+    include RawAttributes
     include Pageable
 
     attr_reader :applications
 
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_page_fields(hash)
       @applications = (hash['applications'] || []).map { |a| Application.from_hash(a) }
     end