sendly 3.6.0 → 3.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc3667b089d1fc494d8d71a8a184a448ee23040ccab772e3640da4743385b291
-  data.tar.gz: a0ccba6bb44cdbfa5a5b01d4882731d1f56c08944b7477f45cf3b779177285c6
+  metadata.gz: b353bcac8423f595cc655af69df19ac4af9afd9f3d830cc7ac0c59842ae7a73f
+  data.tar.gz: ca2e303192d3b22856595bf9981eb28edd3c5ba5f500f544ffeda4783bd28893
 SHA512:
-  metadata.gz: 5e59c3aadde64d289b0efca5e7658e2c248846def6233c6c181c070fefa30438d6aaa1bb1eaa25a1fb2f76336d0613d4a4c10d98ddc1d0ef7e97eea2fdc630d9
-  data.tar.gz: 5ded3801ac0f23d66eaf86628f0e86262fe0f3d028734db22aedaa45cfce4ba3ed951bbf2cfdd4e9a7e41d4f18f053e260cea0224dfd314af33549f153411853
+  metadata.gz: fc1fd77a1fef96c5938c35b4dc948954e24974ae107a7744ddbcfb5d11a15fd744616b0053c2af19fd7cb7b3c8410de2751cb077e1697fb1b48061d10d52d71b
+  data.tar.gz: c2f010e7116ad34275cf88132cc7a8f3874c1b95081597b250d41088780f1662a5367587a7d2b76123fdc4f6d3bf25b42180183e925bfeab58c43b516ee9d78b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    sendly (3.6.0)
+    sendly (3.8.1)
       faraday (~> 2.0)
       faraday-retry (~> 2.0)
 

data/README.md

@@ -182,6 +182,16 @@ status = client.messages.get_batch("batch_xxx")
 
 # List all batches
 batches = client.messages.list_batches
+
+# Preview batch (dry run) - validates without sending
+preview = client.messages.preview_batch(
+  messages: [
+    { to: '+15551234567', text: 'Hello User 1!' },
+    { to: '+447700900123', text: 'Hello UK!' }
+  ]
+)
+puts "Total credits needed: #{preview.total_credits}"
+puts "Valid: #{preview.valid}, Invalid: #{preview.invalid}"
 ```
 
 ### Iterate All Messages
@@ -256,6 +266,17 @@ result = client.account.list_api_keys
 result.data.each do |key|
   puts "#{key.name}: #{key.prefix}*** (#{key.type})"
 end
+
+# Create a new API key
+new_key = client.account.create_api_key(
+  name: 'Production Key',
+  type: 'live',
+  scopes: ['sms:send', 'sms:read']
+)
+puts "New key: #{new_key.key}"  # Only shown once!
+
+# Revoke an API key
+client.account.revoke_api_key('key_xxx')
 ```
 
 ## Error Handling

data/lib/sendly/account_resource.rb

@@ -66,5 +66,33 @@ module Sendly
     def api_key_usage(key_id)
       @client.get("/keys/#{key_id}/usage")
     end
+
+    # Create a new API key
+    #
+    # @param name [String] Display name for the API key
+    # @param expires_at [String, nil] Optional expiration date (ISO 8601)
+    # @return [Hash] Contains 'apiKey' (metadata) and 'key' (full secret - only shown once!)
+    #
+    # @example
+    #   result = client.account.create_api_key("Production")
+    #   puts "Save this key: #{result['key']}"  # Only shown once!
+    def create_api_key(name, expires_at: nil)
+      raise ArgumentError, "API key name is required" if name.nil? || name.empty?
+
+      body = { name: name }
+      body[:expiresAt] = expires_at if expires_at
+
+      @client.post("/account/keys", body)
+    end
+
+    # Revoke an API key
+    #
+    # @param key_id [String] API key ID to revoke
+    # @return [void]
+    def revoke_api_key(key_id)
+      raise ArgumentError, "API key ID is required" if key_id.nil? || key_id.empty?
+
+      @client.delete("/account/keys/#{key_id}")
+    end
   end
 end

data/lib/sendly/messages.rb

@@ -282,6 +282,44 @@ module Sendly
       client.get("/messages/batches", params.compact)
     end
 
+    # Preview a batch without sending (dry run)
+    #
+    # @param messages [Array<Hash>] Array of messages with :to and :text keys
+    # @param from [String] Sender ID or phone number (optional, applies to all)
+    # @param message_type [String] Message type: "marketing" (default) or "transactional"
+    # @return [Hash] Preview showing what would happen if batch was sent
+    #
+    # @raise [Sendly::ValidationError] If parameters are invalid
+    #
+    # @example
+    #   preview = client.messages.preview_batch(
+    #     messages: [
+    #       { to: "+15551234567", text: "Hello Alice!" },
+    #       { to: "+15559876543", text: "Hello Bob!" }
+    #     ]
+    #   )
+    #   puts "Can send: #{preview['canSend']}"
+    #   puts "Credits needed: #{preview['creditsNeeded']}"
+    def preview_batch(messages:, from: nil, message_type: nil)
+      raise ValidationError, "Messages array is required" if messages.nil? || messages.empty?
+
+      messages.each_with_index do |msg, i|
+        raise ValidationError, "Message at index #{i} missing 'to'" unless msg[:to] || msg["to"]
+        raise ValidationError, "Message at index #{i} missing 'text'" unless msg[:text] || msg["text"]
+
+        to = msg[:to] || msg["to"]
+        text = msg[:text] || msg["text"]
+        validate_phone!(to)
+        validate_text!(text)
+      end
+
+      body = { messages: messages }
+      body[:from] = from if from
+      body[:messageType] = message_type if message_type
+
+      client.post("/messages/batch/preview", body)
+    end
+
     private
 
     def validate_phone!(phone)

data/lib/sendly/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sendly
-  VERSION = "3.6.0"
+  VERSION = "3.8.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendly
 version: !ruby/object:Gem::Version
-  version: 3.6.0
+  version: 3.8.1
 platform: ruby
 authors:
 - Sendly
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-01-01 00:00:00.000000000 Z
+date: 2026-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday