didww-v3 5.1.0 → 5.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39b910fbb0b5dc4425cf053fd6cacef936c7c46510f8586d33784cccad18a95e
-  data.tar.gz: 1dae18d3341a93e2a2b4c74d81e224e0402a8c7020bda0053fb685be5186abb2
+  metadata.gz: c780bc13f7f052f1733482ee69b37994b6bd8c9926a498857947faf23865c8d2
+  data.tar.gz: 22be4b92ea6dd9616dc2e67b77b51b3305876b51b6fed40cba6ce7abb8d015e5
 SHA512:
-  metadata.gz: eba0ac2332cf5f0f4c1f65155c0714d9ce35f0a96227024d2b3a21ab650c44587c789035cfb3dd995d797a08573e821eb1301e00732f91cdb3732175c163177c
-  data.tar.gz: a1ebd2311fa0b1f190d068a210ccfe583b74e3b6ec83c7ad368f2f2eb69d2bdf7d40b8ad5ddb98ab2828b2061ce20a77a67db2406b9c30e5ed4f417d20454259
+  metadata.gz: 0c80b1331067374890afec7505eeff625af09f4c36d6e093585483005091c56db11cfd36a4a6ba62547c3e3a300d9b7acc37d78502c8db45f8a91f6cf86c9b83
+  data.tar.gz: 549b86aadb2a060b2ed3ae5f84e4d9f0140c012080087ee84b7feb800137957b0726f39c347a1574ea1109e09e8d39b875b2f416389e8633f4cd008f092ca44a

data/CHANGELOG.md

@@ -4,6 +4,47 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.3.0]
+### Added
+- `DIDWW::Client.customize_connection` to allow customizing the Faraday connection (e.g. proxy, timeouts, custom middleware).
+
+## [5.2.0]
+### Changes
+- Extract status predicate methods into `HasStatusHelpers` concern.
+- Merge shared auth header logic into `BaseMiddleware`, `JsonapiMiddleware` inherits and adds `Content-Type`.
+- Replace 29 resource accessor methods with `RESOURCE_CLASSES` hash and `define_method`.
+- Document date and datetime field types in README.
+
+### Fixed
+- Fix date type attributes: use `:time` for ISO 8601 timestamps.
+- Add missing resource fields: `reference`, `permanent`, `iso`, `contact_email`.
+- Add `requirement` relationship to `DidGroup`.
+- Skip `Api-Key` header on `public_keys` endpoint.
+- Add `User-Agent` header to export download.
+- Use timing-safe comparison for callback signature validation.
+- Fix `is_expired` boolean changed to `expires_at` date on `Proof`.
+
+## [5.1.0]
+### Added
+- `X-DIDWW-API-Version` header sent with requests.
+- Exclusive relationship auto-nullification for DID `voice_in_trunk`/`voice_in_trunk_group`.
+- Export gzip decompression support (`.csv.gz`).
+- `VoiceOutTrunk` CRUD tests and fixtures.
+
+### Changes
+- Rename test fixtures from `sample_N` to self-descriptive names.
+
+## [5.0.0]
+### Breaking Changes
+- Remove H323 and IAX2 trunk configuration support.
+- Update dependencies and CI for current Ruby/Rails versions.
+
+### Added
+- Add missing relationship declarations and tests for included resources.
+
+### Fixed
+- Fix compatibility with `json_api_client` 1.23.0 and newer Ruby.
+
 ## [4.1.0]
 ### Breaking Changes
 - removed DIDWW::Resource::DidGroup::FEATURE_VOICE in favor DIDWW::Resource::DidGroup::FEATURE_VOICE_IN and DIDWW::Resource::DidGroup::FEATURE_VOICE_OUT [#42](https://github.com/didww/didww-v3-ruby/pull/42)

data/README.md

@@ -51,17 +51,17 @@ Or install it yourself as:
 ```ruby
 require 'didww'
 
-client = DIDWW::Client.configure do |config|
+DIDWW::Client.configure do |config|
   config.api_key  = 'YOUR_API_KEY'
   config.api_mode = :sandbox
 end
 
 # Check balance
-balance = client.balance
+balance = DIDWW::Client.balance
 puts "Balance: #{balance.total_balance}"
 
 # List DID groups with stock keeping units
-did_groups = client.did_groups.all(
+did_groups = DIDWW::Client.did_groups.all(
   include: 'stock_keeping_units',
   filter: { area_name: 'Acapulco' }
 )
@@ -69,14 +69,10 @@ did_groups = client.did_groups.all(
 puts "DID groups: #{did_groups.count}"
 ```
 
-For more examples visit [examples](examples/).
-
 For details on obtaining your API key please visit https://doc.didww.com/api3/configuration.html
 
 ## Examples
 
-- Source code: [examples/](examples/)
-- How to run: [examples/README.md](examples/README.md)
 - Rails integration sample: https://github.com/didww/didww-v3-rails-sample
 
 ## Configuration
@@ -104,6 +100,36 @@ end
 | `:production` | `https://api.didww.com/v3/` |
 | `:sandbox` | `https://sandbox-api.didww.com/v3/` |
 
+### Connection Customization
+
+Use `customize_connection` to customize the underlying Faraday connection, for example to configure a proxy or add custom middleware:
+
+```ruby
+# Using a proxy
+DIDWW::Client.configure do |config|
+  config.api_key  = 'YOUR_API_KEY'
+  config.api_mode = :production
+  config.customize_connection do |conn|
+    # conn is a JsonApiClient::Connection instance
+    conn.faraday.proxy = 'http://proxy.example.com:8080'
+  end
+end
+```
+
+```ruby
+# Adding custom middleware and timeouts
+DIDWW::Client.configure do |config|
+  config.api_key  = 'YOUR_API_KEY'
+  config.api_mode = :production
+  config.customize_connection do |conn|
+    # conn is a JsonApiClient::Connection instance
+    conn.use MyCustomMiddleware
+    conn.faraday.options.timeout = 30
+    conn.faraday.options.open_timeout = 10
+  end
+end
+```
+
 ### API Version
 
 The SDK sends `X-DIDWW-API-Version: 2022-05-10` by default. You can override it per block:
@@ -168,6 +194,7 @@ trunk = DIDWW::Client.voice_in_trunks.new(
   name: 'My SIP Trunk',
   configuration: {
     type: 'sip_configurations',
+    username: '{DID}',
     host: 'sip.example.com',
     port: 5060
   }
@@ -192,10 +219,70 @@ order = DIDWW::Client.orders.new(
 order.save
 ```
 
+## Date and Datetime Fields
+
+The SDK distinguishes between date-only and datetime fields:
+
+- **Datetime fields** — deserialized as `Time`:
+  - All `created_at` fields — present on most resources (`EncryptedFile` has no `created_at`)
+  - Expiry fields: `Did#expires_at`, `DidReservation#expire_at`, `Proof#expires_at`, `EncryptedFile#expire_at`
+- **Date-only fields** — deserialized as `Date`:
+  - `Identity#birth_date`
+- **Date-only fields kept as strings** (`CapacityPool#renew_date`) remain as `String`.
+
+```ruby
+did = DIDWW::Client.dids.find("uuid").first
+puts did.created_at   # => 2024-01-15 10:00:00 UTC  (Time)
+puts did.expires_at   # => nil or 2025-01-15 10:00:00 UTC  (Time)
+
+identity = DIDWW::Client.identities.find("uuid").first
+puts identity.birth_date  # => 1990-05-20  (Date)
+```
+
 ## Resource Relationships
 
 See [docs/resource_relationships.md](docs/resource_relationships.md) for a Mermaid ER diagram showing all `has_one`, `has_many`, and `belongs_to` relationships between resources.
 
+## Webhook Signature Validation
+
+Validate incoming webhook callbacks from DIDWW using HMAC-SHA1 signature verification.
+
+```ruby
+require 'didww/callback/request_validator'
+
+validator = DIDWW::Callback::RequestValidator.new("YOUR_API_KEY")
+
+# In your webhook handler:
+valid = validator.validate(
+  request_url,    # full original URL
+  payload_params, # Hash of payload key-value pairs
+  signature       # value of X-DIDWW-Signature header
+)
+```
+
+The signature header name is available as the constant `DIDWW::Callback::RequestValidator::HEADER`.
+
+### Rails Example
+
+```ruby
+class WebhooksController < ApplicationController
+  skip_before_action :verify_authenticity_token
+
+  def create
+    validator = DIDWW::Callback::RequestValidator.new("YOUR_API_KEY")
+    signature = request.headers[DIDWW::Callback::RequestValidator::HEADER]
+    params_hash = request.POST
+
+    if validator.validate(request.original_url, params_hash, signature)
+      # Process the webhook
+      head :ok
+    else
+      head :forbidden
+    end
+  end
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/examples/README.md

@@ -0,0 +1,86 @@
+# Examples
+
+All examples read the API key from the `DIDWW_API_KEY` environment variable.
+
+## Prerequisites
+
+- Ruby 3.3+
+- Bundler
+- DIDWW API key for sandbox account
+
+## Environment variables
+
+- `DIDWW_API_KEY` (required): your DIDWW API key
+
+## Install
+
+```bash
+cd examples && bundle install
+```
+
+## Run an example
+
+```bash
+DIDWW_API_KEY=your_api_key ruby examples/orders_nanpa.rb
+```
+
+## Available examples
+
+### Core Resources
+| Script | Description |
+|---|---|
+| [`balance.rb`](balance.rb) | Fetches and prints current account balance and credit. |
+| [`countries.rb`](countries.rb) | Lists countries, demonstrates filtering, and fetches one country by ID. |
+| [`regions.rb`](regions.rb) | Lists regions with filters/includes and fetches a specific region. |
+| [`did_groups.rb`](did_groups.rb) | Fetches DID groups with included SKUs and shows group details. |
+| [`dids.rb`](dids.rb) | Updates DID routing/capacity by assigning trunk and capacity pool. |
+| [`exports.rb`](exports.rb) | Lists CDR exports and their details. |
+
+### Voice In (Inbound)
+| Script | Description |
+|---|---|
+| [`voice_in_trunks.rb`](voice_in_trunks.rb) | Lists voice in trunks and their configurations. |
+| [`voice_in_trunk_groups.rb`](voice_in_trunk_groups.rb) | CRUD for trunk groups with trunk relationships. |
+
+### Voice Out (Outbound)
+| Script | Description |
+|---|---|
+| [`voice_out_trunks.rb`](voice_out_trunks.rb) | CRUD for voice out trunks (requires account config). |
+
+### Capacity Management
+| Script | Description |
+|---|---|
+| [`capacity_pools.rb`](capacity_pools.rb) | Lists capacity pools with included shared capacity groups. |
+| [`shared_capacity_groups.rb`](shared_capacity_groups.rb) | Creates a shared capacity group in a capacity pool. |
+
+### Orders - Basic
+| Script | Description |
+|---|---|
+| [`orders.rb`](orders.rb) | Lists orders and creates/cancels a DID order using live SKU lookup. |
+| [`orders_nanpa.rb`](orders_nanpa.rb) | Orders a DID number by NPA/NXX prefix. |
+| [`orders_by_sku.rb`](orders_by_sku.rb) | Creates a DID order by SKU resolved from DID groups. |
+| [`orders_capacity.rb`](orders_capacity.rb) | Purchases capacity by creating a capacity order item. |
+
+### Orders - Advanced
+| Script | Description |
+|---|---|
+| [`orders_available_dids.rb`](orders_available_dids.rb) | Orders an available DID using included DID group SKU. |
+| [`orders_reservation_dids.rb`](orders_reservation_dids.rb) | Reserves a DID and then places an order from that reservation. |
+| [`orders_all_item_types.rb`](orders_all_item_types.rb) | Creates a DID order with all item types: by SKU, available DID, and reservation. |
+
+### DID Management
+| Script | Description |
+|---|---|
+| [`did_reservations.rb`](did_reservations.rb) | Lists DID reservations and available DIDs. |
+| [`did_trunk_assignment.rb`](did_trunk_assignment.rb) | Demonstrates exclusive trunk/trunk group assignment on DIDs. |
+
+### Compliance & Verification
+| Script | Description |
+|---|---|
+| [`identities_and_proofs.rb`](identities_and_proofs.rb) | Creates identities, addresses, and demonstrates proof workflow. |
+
+## Troubleshooting
+
+If `DIDWW_API_KEY` is missing, examples fail fast with:
+
+`Please set DIDWW_API_KEY`

data/examples/balance.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+# Fetches and prints current account balance and credit.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/balance.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+balance = DIDWW::Client.balance
+puts "Total Balance: #{balance.total_balance}"
+puts "Balance: #{balance.balance}"
+puts "Credit: #{balance.credit}"

data/examples/capacity_pools.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+# Lists capacity pools with included shared capacity groups.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/capacity_pools.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# List capacity pools with included shared capacity groups
+puts '=== Capacity Pools ==='
+capacity_pools = DIDWW::Client.capacity_pools
+                  .includes(:shared_capacity_groups)
+                  .all
+
+puts "Found #{capacity_pools.size} capacity pools"
+
+capacity_pools.each do |pool|
+  puts "\nCapacity Pool: #{pool.name}"
+  puts "  Total channels: #{pool.total_channels_count}"
+  puts "  Assigned channels: #{pool.assigned_channels_count}"
+  puts "  Monthly price: #{pool.monthly_price}"
+  puts "  Metered rate: #{pool.metered_rate}"
+
+  if pool.shared_capacity_groups && !pool.shared_capacity_groups.empty?
+    puts '  Shared Capacity Groups:'
+    pool.shared_capacity_groups.each do |group|
+      puts "    - #{group.name} (#{group.shared_channels_count} channels)"
+    end
+  end
+end

data/examples/countries.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+# Lists countries, demonstrates filtering, and fetches one country by ID.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/countries.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# List all countries
+puts '=== All Countries ==='
+countries = DIDWW::Client.countries.all
+countries.first(5).each do |country|
+  puts "#{country.name} (+#{country.prefix}) [#{country.iso}]"
+end
+
+# Filter countries by name
+puts "\n=== Filtered Countries (United States) ==="
+filtered = DIDWW::Client.countries.where(name: 'United States').all
+puts "Found: #{filtered.size} countries"
+filtered.each do |country|
+  puts "#{country.name} (+#{country.prefix})"
+end
+
+# Find a specific country
+if !filtered.empty?
+  puts "\n=== Specific Country ==="
+  country = DIDWW::Client.countries.find(filtered.first.id).first
+  puts "Found: #{country.name}"
+end

data/examples/did_groups.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+# Fetches DID groups with included SKUs and shows group details.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/did_groups.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# Fetch DID groups with included stock_keeping_units
+puts '=== DID Groups with SKUs ==='
+did_groups = DIDWW::Client.did_groups
+              .includes(:stock_keeping_units)
+              .all
+
+puts "Found #{did_groups.size} DID groups"
+
+did_groups.first(3).each do |did_group|
+  puts "\nDID Group: #{did_group.id}"
+  puts "  Area: #{did_group.area_name}"
+  puts "  Prefix: #{did_group.prefix}"
+  puts "  Metered: #{did_group.is_metered}"
+  puts "  Features: #{did_group.features_human}"
+
+  if did_group.stock_keeping_units && !did_group.stock_keeping_units.empty?
+    puts '  SKUs:'
+    did_group.stock_keeping_units.each do |sku|
+      puts "    - #{sku.id} (monthly: #{sku.monthly_price})"
+    end
+  end
+end
+
+# Find a specific DID group
+if !did_groups.empty?
+  puts "\n=== Specific DID Group ==="
+  did_group = DIDWW::Client.did_groups
+               .includes(:stock_keeping_units)
+               .find(did_groups.first.id)
+               .first
+  puts "Found: #{did_group.area_name} (prefix: #{did_group.prefix})"
+end

data/examples/did_reservations.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+# Lists DID reservations and available DIDs.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/did_reservations.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# List DID reservations
+puts '=== Existing DID Reservations ==='
+reservations = DIDWW::Client.did_reservations
+                .includes(:available_did)
+                .all
+
+puts "Found #{reservations.size} DID reservations"
+reservations.first(10).each do |reservation|
+  did_number = reservation.available_did ? reservation.available_did.number : 'unknown'
+  puts "#{reservation.id}"
+  puts "  DID: #{did_number}"
+  puts "  Expires: #{reservation.expire_at}"
+  puts "  Created: #{reservation.created_at}"
+  puts ''
+end
+
+# List available DIDs
+puts "\n=== Available DIDs ==="
+available_dids = DIDWW::Client.available_dids
+                  .includes(:did_group)
+                  .all
+
+puts "Found #{available_dids.size} available DIDs"
+available_dids.first(10).each do |available_did|
+  puts "#{available_did.number}"
+  if available_did.did_group
+    puts "  Group: #{available_did.did_group.area_name}"
+    puts "  Prefix: #{available_did.did_group.prefix}"
+  end
+  puts ''
+end
+
+# Find a specific reservation if available
+if !reservations.empty?
+  puts "\n=== Specific Reservation Details ==="
+  specific_reservation = DIDWW::Client.did_reservations
+                         .find(reservations.first.id)
+                         .first
+  puts "Reservation: #{specific_reservation.id}"
+  puts "  Expires at: #{specific_reservation.expire_at}"
+  puts "  Created at: #{specific_reservation.created_at}"
+end

data/examples/did_trunk_assignment.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+# Demonstrates exclusive trunk/trunk group assignment on DIDs.
+# Assigning a trunk auto-nullifies the trunk group and vice versa.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/did_trunk_assignment.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# Get a DID to work with
+puts '=== Finding DID ==='
+dids = DIDWW::Client.dids
+       .includes(:voice_in_trunk, :voice_in_trunk_group)
+       .all
+
+if dids.empty?
+  puts 'No DIDs found. Please order a DID first.'
+  exit 1
+end
+
+did = dids.first
+puts "Using DID: #{did.number} (#{did.id})"
+
+# Get a trunk
+puts "\n=== Finding Trunk ==="
+trunks = DIDWW::Client.voice_in_trunks.all
+
+if trunks.empty?
+  puts 'No trunks found. Please create a trunk first.'
+  exit 1
+end
+
+trunk = trunks.first
+puts "Selected trunk: #{trunk.name} (#{trunk.id})"
+
+# Get a trunk group
+puts "\n=== Finding Trunk Group ==="
+trunk_groups = DIDWW::Client.voice_in_trunk_groups.all
+
+if trunk_groups.empty?
+  puts 'No trunk groups found. Please create a trunk group first.'
+  exit 1
+end
+
+trunk_group = trunk_groups.first
+puts "Selected trunk group: #{trunk_group.name} (#{trunk_group.id})"
+
+def print_did_assignment(client, did_id)
+  result = client.dids
+           .includes(:voice_in_trunk, :voice_in_trunk_group)
+           .find(did_id)
+           .first
+  trunk = result.voice_in_trunk ? result.voice_in_trunk.id : 'null'
+  group = result.voice_in_trunk_group ? result.voice_in_trunk_group.id : 'null'
+  puts "   trunk = #{trunk}"
+  puts "   group = #{group}"
+end
+
+begin
+  # 1. Assign trunk to DID (auto-nullifies trunk group)
+  puts "\n=== 1. Assigning trunk to DID ==="
+  did.voice_in_trunk = trunk
+  if did.save
+    print_did_assignment(DIDWW::Client, did.id)
+  else
+    puts "Error assigning trunk: #{did.errors.full_messages}"
+  end
+
+  # 2. Assign trunk group to DID (auto-nullifies trunk)
+  puts "\n=== 2. Assigning trunk group to DID ==="
+  did_fresh = DIDWW::Client.dids.find(did.id).first
+  did_fresh.voice_in_trunk_group = trunk_group
+  if did_fresh.save
+    print_did_assignment(DIDWW::Client, did.id)
+  else
+    puts "Error assigning trunk group: #{did_fresh.errors.full_messages}"
+  end
+
+  # 3. Re-assign trunk (auto-nullifies trunk group again)
+  puts "\n=== 3. Re-assigning trunk ==="
+  did_fresh = DIDWW::Client.dids.find(did.id).first
+  did_fresh.voice_in_trunk = trunk
+  if did_fresh.save
+    print_did_assignment(DIDWW::Client, did.id)
+  else
+    puts "Error re-assigning trunk: #{did_fresh.errors.full_messages}"
+  end
+
+  # 4. Update description only (trunk stays assigned)
+  puts "\n=== 4. Updating description only (trunk stays) ==="
+  did_fresh = DIDWW::Client.dids.find(did.id).first
+  did_fresh.description = 'DID with trunk assigned'
+  if did_fresh.save
+    print_did_assignment(DIDWW::Client, did.id)
+  else
+    puts "Error updating description: #{did_fresh.errors.full_messages}"
+  end
+
+  puts "\nDemonstration complete!"
+rescue StandardError => e
+  puts "Error: #{e.message}"
+end

data/examples/dids.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+# Updates DID routing/capacity by assigning trunk and capacity pool.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/dids.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# Get the last ordered DID
+puts '=== Finding last ordered DID ==='
+dids = DIDWW::Client.dids
+        .all
+
+if dids.empty?
+  puts 'No DIDs found. Please order a DID first.'
+  exit 1
+end
+
+did = dids.first
+puts "Selected DID: #{did.id}"
+
+# Get last SIP trunk
+puts "\n=== Finding SIP trunk ==="
+trunks = DIDWW::Client.voice_in_trunks
+          .where('configuration.type': 'sip_configurations')
+          .all
+
+if trunks.empty?
+  puts 'No SIP trunks found. Please create a SIP trunk first.'
+  exit 1
+end
+
+trunk = trunks.first
+puts "Selected trunk: #{trunk.name}"
+
+# Assign trunk to DID
+puts "\n=== Assigning trunk to DID ==="
+did.voice_in_trunk = trunk
+updated_did = did.save
+puts "Assigned trunk: #{did.voice_in_trunk.name if did.voice_in_trunk}"
+
+# Assign capacity pool
+puts "\n=== Assigning capacity pool ==="
+capacity_pools = DIDWW::Client.capacity_pools.all
+
+if !capacity_pools.empty?
+  pool = capacity_pools.first
+  did.capacity_pool = pool
+  did.capacity_limit = 5
+  did.description = 'Updated by Ruby example'
+  did.save
+  puts "DID #{did.id}"
+  puts "  description: #{did.description}"
+  puts "  capacity_limit: #{did.capacity_limit}"
+else
+  puts 'No capacity pools found'
+end