sendly 3.6.0 → 3.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc3667b089d1fc494d8d71a8a184a448ee23040ccab772e3640da4743385b291
-  data.tar.gz: a0ccba6bb44cdbfa5a5b01d4882731d1f56c08944b7477f45cf3b779177285c6
+  metadata.gz: c6f94a917e0e9fe4109e3edc96008fc4381797e46e494f22834f74b4905cdd9c
+  data.tar.gz: fcf628838872a190ae6e4c54e2b9be79689d3f1500bac36938daff8e1b6df38e
 SHA512:
-  metadata.gz: 5e59c3aadde64d289b0efca5e7658e2c248846def6233c6c181c070fefa30438d6aaa1bb1eaa25a1fb2f76336d0613d4a4c10d98ddc1d0ef7e97eea2fdc630d9
-  data.tar.gz: 5ded3801ac0f23d66eaf86628f0e86262fe0f3d028734db22aedaa45cfce4ba3ed951bbf2cfdd4e9a7e41d4f18f053e260cea0224dfd314af33549f153411853
+  metadata.gz: b07d5bcaadfabd4f532cc27e3179dea0a5356b27492fde834682ae033565feea85a6a0254dfdaa30a927851e08f668b9b4bf09f4dac59cb232d3a5cb6b30033d
+  data.tar.gz: 40741e416c8d3a91abd08414c5066180828a582af6782250b7975c50c8b653167cf960067acb1bde3e8e9501abfc7572914da7b547efcc4ff7289281dbaff41d

data/Gemfile.lock

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

data/README.md

@@ -1,3 +1,12 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SendlyHQ/sendly-ruby/main/.github/header.svg" alt="Sendly Ruby SDK" />
+</p>
+
+<p align="center">
+  <a href="https://rubygems.org/gems/sendly"><img src="https://img.shields.io/gem/v/sendly.svg?style=flat-square" alt="RubyGems" /></a>
+  <a href="https://github.com/SendlyHQ/sendly-ruby/blob/main/LICENSE"><img src="https://img.shields.io/github/license/SendlyHQ/sendly-ruby?style=flat-square" alt="license" /></a>
+</p>
+
 # Sendly Ruby SDK
 
 Official Ruby SDK for the Sendly SMS API.
@@ -182,6 +191,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 +275,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.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendly
 version: !ruby/object:Gem::Version
-  version: 3.6.0
+  version: 3.8.2
 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
@@ -131,13 +131,13 @@ files:
 - lib/sendly/version.rb
 - lib/sendly/webhooks.rb
 - lib/sendly/webhooks_resource.rb
-homepage: https://github.com/sendly-live/sendly-ruby
+homepage: https://github.com/SendlyHQ/sendly-ruby
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/sendly-live/sendly-ruby
-  source_code_uri: https://github.com/sendly-live/sendly-ruby
-  changelog_uri: https://github.com/sendly-live/sendly-ruby/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/SendlyHQ/sendly-ruby
+  source_code_uri: https://github.com/SendlyHQ/sendly-ruby
+  changelog_uri: https://github.com/SendlyHQ/sendly-ruby/blob/main/CHANGELOG.md
   documentation_uri: https://sendly.live/docs
 post_install_message: 
 rdoc_options: []