sendara 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4dc1a93353c4f74c9858a5c0456819cf09d8822bfc2d85e52380310800ab361
-  data.tar.gz: 01b26945825759c360b80e0fa82be866b76daeb75632a2aae4800b79eb7024a4
+  metadata.gz: 36b63c37d1614f2443d015ee439a65a2504238aa6f53608909b4d38ef686dd3c
+  data.tar.gz: 31e7a59ebfd8b679dc2e27e518d1220d75e4dd60f68c1478244c663233493294
 SHA512:
-  metadata.gz: d2ff26bc76b493d4f12dabfeba8aecf5bee14192bc2bae40fc31ba7e85f6c4116b89b1d5293912869f8278588c3729e7ceecbc6e431bb7b5ef4793a835059b93
-  data.tar.gz: 1792963bb32043679409cc010483e1fb7a0cb9fa9af8019656cce503370ec1b8e6b8130dc47ed7d27f99c1b3c91d1d45026d6281fa9bb630a1742f3c93759f55
+  metadata.gz: e6189e38a294454656bb302f5009e1383fec9919e451c26f4b90ccdb59087aa3e1fd35369b68dd1eb505327c632a3f029b7f2c29bbbd2c86114fbcfae3f94013
+  data.tar.gz: 99ea454fab47746eb0b36780a43c8b02ee9ffac82447b812b60681b092b8cd4bf4d72476d581535ee34dfaed0579b0082a280379b4259175d74b8cb94421a69b

data/README.md

@@ -158,10 +158,10 @@ client.broadcasts.bulk_send(
 
 ## Messages & pagination
 
-Fetch a single page with `messages.page`, which returns a `Sendara::MessagePage`:
+Fetch a single page with `messages.page` (aliased as `messages.list`), which returns a `Sendara::MessagePage`:
 
 ```ruby
-page = client.messages.page(status: "delivered", limit: 50)
+page = client.messages.list(status: "delivered", limit: 50)
 
 page.messages.each { |message| puts message["id"] }
 page.has_more?   # => true / false
@@ -182,10 +182,11 @@ Called without a block it returns an `Enumerator`, so the full `Enumerable` API
 recent = client.messages.each(channel: "email", limit: 100).first(10)
 ```
 
-Filters: `channel`, `status`, `from`, `to`, `limit`, `cursor`. Fetch one message by id:
+Filters: `channel`, `status`, `search`, `from`, `to`, `limit`, `cursor`. Fetch one message with its full event timeline, by id or by the idempotency key from the original send:
 
 ```ruby
 client.messages.get("msg_123")
+client.messages.get(idempotency_key: "order-42")
 ```
 
 ## Webhook verification

data/lib/sendara/resources/messages.rb

@@ -5,10 +5,11 @@ module Sendara
     class Messages < Resource
       include Enumerable
 
-      def page(channel: nil, status: nil, from: nil, to: nil, limit: nil, cursor: nil)
+      def page(channel: nil, status: nil, search: nil, from: nil, to: nil, limit: nil, cursor: nil)
         query = compact_params(
           "channel" => channel,
           "status" => status,
+          "search" => search,
           "from" => from,
           "to" => to,
           "limit" => limit,
@@ -18,15 +19,17 @@ module Sendara
         MessagePage.from_response(response)
       end
 
-      def each(channel: nil, status: nil, from: nil, to: nil, limit: nil, cursor: nil, &block)
+      alias list page
+
+      def each(channel: nil, status: nil, search: nil, from: nil, to: nil, limit: nil, cursor: nil, &block)
         unless block_given?
-          return enum_for(:each, channel: channel, status: status, from: from,
-                                  to: to, limit: limit, cursor: cursor)
+          return enum_for(:each, channel: channel, status: status, search: search,
+                                  from: from, to: to, limit: limit, cursor: cursor)
         end
 
         loop do
-          current = page(channel: channel, status: status, from: from,
-                         to: to, limit: limit, cursor: cursor)
+          current = page(channel: channel, status: status, search: search,
+                         from: from, to: to, limit: limit, cursor: cursor)
           current.messages.each(&block)
           break if current.next_cursor.nil?
 
@@ -34,7 +37,13 @@ module Sendara
         end
       end
 
-      def get(id)
+      def get(id = nil, idempotency_key: nil)
+        if idempotency_key
+          return request(:get, "/v1/messages", query: { "idempotency_key" => idempotency_key }) || {}
+        end
+
+        raise ArgumentError, "get requires an id or idempotency_key" if id.nil?
+
         request(:get, "/v1/messages/#{encode(id)}") || {}
       end
     end

data/lib/sendara/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sendara
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendara
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Sendara
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-18 00:00:00.000000000 Z
+date: 2026-06-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec