twi 0.3.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3da0ed4a9e8746dd8609affeb9cf316a156dafa9a20b0da5e5307c37ea95ad0
-  data.tar.gz: 647d377b97c2fc7951ecd61f3caeb100b5d4ceeb8e1a8d788a5ba0b623a60ef9
+  metadata.gz: ad98e587f9dba0c2812169dfc04958634e683ebc2e2208b1d693e7de8f90b543
+  data.tar.gz: 1515528e3fcbe515f6831f21fa859214a8c2d274cb79ad4341db5808550d1a77
 SHA512:
-  metadata.gz: 375a364348e16d823426c5670e22a900f52d50d5ee9ac2405f80cd6cd9e3cd7052e20d2d8511f50d44036f579ce273d8a2929908f470fd01aeeaf576e0ec6993
-  data.tar.gz: 97361223e531df80107ed916fa9f81774a9a8694a2e9df8b7acc5dd58468f02c10616df901e798d88f3be3e93b9f1cd4b4c8a3952525ab618378ea1d5a520063
+  metadata.gz: 20029e35bb9768472e97be71146d350879ea694453e835f248892f78306e8aa41d4da8d8a497ee71144f62d6f3d0a82a537d0aa3647ba2d7d83697502a24dbd5
+  data.tar.gz: 3f766ce5571a8cc438ea37c2bc2aed10f92ea1aa5f12606fca36691a7ab86fb2486651f8d74478fc794bdf3187f67be5789b394b810ac86bf2dbcd52fd14cb50

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [0.3.2] - 2026-06-01
+
+- [New] Add Twi::Message.url_for, Twi::Delivery.url_for, Twi::Delivery.unsubscribed?
+
+## [0.3.1] - 2026-06-01
+
+- [New] Raise Twi::Error, not Twilio::REST::RestError
+
 ## [0.3.0] - 2026-05-27
 
 - [New] Add Twi::Message#create

data/lib/twi/conversation.rb

@@ -30,6 +30,12 @@ module Twi
       conversation.delete
     end
 
+    def url
+      url = "/console/conversations/services/#{Twi.lio.conversation_sid}/conversations/#{id}/messages"
+      query = "currentFrameUrl=#{CGI.escape url}"
+      "https://console.twilio.com/us1/develop/conversations/manage/services?#{query}"
+    end
+
     def create_message(content:, image_ids: [])
       conversation.messages.create **message_params_for(content, image_ids)
     end

data/lib/twi/delivery.rb

@@ -12,6 +12,14 @@ module Twi
     # @return [String, nil] error code
     def code = @params['ErrorCode']
 
+    # @return [String] documentation URL for given error code.
+    def self.url_for(code)
+      "https://www.twilio.com/docs/api/errors/#{code}"
+    end
+
+    # @return [Boolean] whether the delivery failed because the recipient unsubscribed.
+    def self.unsubscribed?(code) = code.eql? '21610'
+
     # @return [Hash] the shape of the payload send by Twilio to the callback URL.
     def self.params_for(id:, status:, code: nil)
       { SmsSid: id, MessageStatus: status, ErrorCode: code }

data/lib/twi/error.rb

@@ -1,5 +1,11 @@
 module Twi
   class Error < StandardError
+    attr_reader :code
+
+    def initialize(attributes = {})
+      @code = attributes[:code]
+      super attributes[:message]
+    end
   end
 
   class ExistingConversationError < Error

data/lib/twi/message.rb

@@ -30,6 +30,12 @@ module Twi
       end
     end
 
+    # @return [String] log URL for given message.
+    def self.url_for(id)
+      account_sid = Twi.lio.account_sid
+      "https://console.twilio.com/us1/monitor/logs/sms/#{account_sid}/#{id}"
+    end
+
     attr_reader :status
 
     # Sends a message.
@@ -39,7 +45,8 @@ module Twi
 
       @id = message.sid
       @status = message.status
-      # todo rescue and then set @code
+    rescue Twilio::REST::RestError => error
+      raise Error, error
     end
 
     # @return [Hash] the shape of the payload send by Twilio to the callback URL.

data/lib/twi/mock/conversation.rb

@@ -1,12 +1,11 @@
 module Twi
   class Mock::Conversation < Conversation
     def create_with(participants:)
-      if Twi.mock.conversation_error
-        if Twi.mock.conversation_error[:code] == 50438
-          raise ExistingConversationError.new(Twi.mock.conversation_error[:message])
-        elsif Twi.mock.conversation_error[:code] == 50214
-          Twi.mock.conversation_error = nil
-          raise TooManyConversationsError
+      if error = Twi.mock.conversation_error
+        Twi.mock.conversation_error = nil
+        case error[:code]
+          when 50438 then raise ExistingConversationError.new(error)
+          when 50214 then raise TooManyConversationsError.new(error)
         end
       elsif Twi.mock.conversation
         @id = Twi.mock.conversation[:id]

data/lib/twi/mock/message.rb

@@ -4,9 +4,16 @@ module Twi
     def id = @params[:id]
 
     def create
-      @id = "SM#{rand}"
-      @status = 'delivered'
-      # todo rescue and then set @code
+      if error = Twi.mock.message_error
+        Twi.mock.message_error = nil
+        raise Error, error
+      elsif Twi.mock.message
+        @id = Twi.mock.message[:id]
+        @status = Twi.mock.message[:status]
+      else
+        @id = "SM#{rand}"
+        @status = 'delivered'
+      end
     end
   end
 end

data/lib/twi/mock.rb

@@ -1,5 +1,8 @@
 module Twi
   class Mock
-    attr_accessor :phone, :phone_error, :message, :conversation, :conversation_error, :medium
+    attr_accessor :phone, :phone_error
+    attr_accessor :message, :message_error
+    attr_accessor :conversation, :conversation_error
+    attr_accessor :medium
   end
 end

data/lib/twi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Twi
-  VERSION = '0.3.0'
+  VERSION = '0.3.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: twi
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.2
 platform: ruby
 authors:
 - Claudio Baccigalupo