unsent 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa505d7132d95fc8d1d1081eacdc6dc1c152d7265775437c7841a63f0cfbab0b
-  data.tar.gz: d173d3f42bb1b159f2a4d59070d7f1c6db41bb8af2771c29d1808f742541394a
+  metadata.gz: 42d9faa896c32041c471383db9a85085ca126b1dce7025b871e649c43225cb84
+  data.tar.gz: 3c664ba5678b2c025c3abd501be29fc42301ad658af48b8fc5d3224b498c815c
 SHA512:
-  metadata.gz: 22ae152f36d21cc5f7dda582594d1b0cb0e667fba6765e9dbf3e14f23e9cf2f65f15f4ff937a09a36303d04d0d4208c5dfd5aa31121bd6c86b759dbc6a40dffd
-  data.tar.gz: 12f06ce781b6c75e5cc7985bd9eaa5dd1f48754715a0115cca022ed3467de14daf716284a373d17a2ea7d8beb7cb5d661b5c8b95ecf5ef0b6be18efd2daec831
+  metadata.gz: e0135b319de54f560145a9158f006034125a3d3e336107ec3b15eaa0dd58a98cbf1ecb4c7528638703e2f0d52f484fe1ef0c66255e7f9b8236b8c7fe9ef831af
+  data.tar.gz: 1d5eff7f34e8a259eaac976cc017f7578f59d29c90fcd23a3d0c14c8b4f806d8e9a24a379f0ec14281d4f4899d175917a215d92c0590752f7aac8c4a7a43ed0f

data/README.md

@@ -307,13 +307,59 @@ data, error = client.emails.get_bounces(page: 1, limit: 10)
 
 # Get unsubscribes
 data, error = client.emails.get_unsubscribes(page: 1, limit: 10)
+
+# Get events for a specific email
+events, error = client.emails.get_events('email_123', page: 1, limit: 10)
+if events
+  events['data'].each do |event|
+    puts "Event: #{event['type']} at #{event['timestamp']}"
+  end
+end
 ```
 
-## Contact Books
+## Domains
+
+Manage your sending domains and retrieve domain-specific analytics.
+
+### Domain Analytics & Statistics
 
-Organize your contacts into separate books.
+```ruby
+# Get analytics for a specific domain
+data, error = client.domains.get_analytics('domain_123', days: 30)
+puts "Total sent: #{data['sent']}, Delivered: #{data['delivered']}" if data
+
+# Get analytics with custom date range
+data, error = client.domains.get_analytics(
+  'domain_123',
+  startDate: '2024-01-01',
+  endDate: '2024-01-31'
+)
+
+# Get domain statistics
+stats, error = client.domains.get_stats('domain_123', days: 7)
+puts "Bounce rate: #{stats['bounceRate']}%" if stats
+
+# Get stats with custom date range
+stats, error = client.domains.get_stats(
+  'domain_123',
+  startDate: '2024-01-01',
+  endDate: '2024-01-15'
+)
+```
+
+### Domain Management
+
+#### List Domains
+
+```ruby
+domains, error = client.domains.list
+domains.each do |domain|
+  puts "Domain: #{domain['domain']}, Status: #{domain['status']}"
+end if domains
+```
+
+#### Create Domain
 
-### Create Contact Book
 
 ```ruby
 data, error = client.contact_books.create(

data/lib/unsent/activity.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Unsent
+  class Activity
+    def initialize(client)
+      @client = client
+    end
+
+    # Retrieve activity feed with email events and email details
+    # @param query [Hash] Query parameters
+    # @option query [Integer] :page Page number (default: 1)
+    # @option query [Integer] :limit Number of items per page (default: 50, max: 100)
+    # @return [Array] Response data and error
+    def get(query = {})
+      params = []
+      params << "page=#{query[:page]}" if query[:page]
+      params << "limit=#{query[:limit]}" if query[:limit]
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/activity#{query_string}")
+    end
+  end
+end

data/lib/unsent/client.rb

@@ -9,7 +9,7 @@ module Unsent
     DEFAULT_BASE_URL = "https://api.unsent.dev"
 
     attr_reader :key, :url, :raise_on_error
-    attr_accessor :emails, :contacts, :campaigns, :domains, :analytics, :api_keys, :contact_books, :settings, :suppressions, :templates, :webhooks
+    attr_accessor :system, :emails, :contacts, :campaigns, :domains, :analytics, :api_keys, :contact_books, :settings, :suppressions, :templates, :webhooks, :events, :metrics, :stats, :activity, :teams
 
     def initialize(key = nil, url: nil, raise_on_error: true)
       @key = key || ENV["UNSENT_API_KEY"] || ENV["UNSENT_API_KEY"]
@@ -20,6 +20,7 @@ module Unsent
       @raise_on_error = raise_on_error
 
       # Initialize resource clients
+      @system = System.new(self)
       @emails = Emails.new(self)
       @contacts = Contacts.new(self)
       @campaigns = Campaigns.new(self)
@@ -31,6 +32,11 @@ module Unsent
       @suppressions = Suppressions.new(self)
       @templates = Templates.new(self)
       @webhooks = Webhooks.new(self)
+      @events = Events.new(self)
+      @metrics = Metrics.new(self)
+      @stats = Stats.new(self)
+      @activity = Activity.new(self)
+      @teams = Teams.new(self)
     end
 
     def request(method, path, body = nil, headers = {})
@@ -72,8 +78,7 @@ module Unsent
       end
 
       begin
-        data = JSON.parse(response.body)
-        [data, nil]
+        JSON.parse(response.body)
       rescue JSON::ParserError
         [nil, default_error]
       end

data/lib/unsent/domains.rb

@@ -25,5 +25,39 @@ module Unsent
     def delete(domain_id)
       @client.delete("/domains/#{domain_id}")
     end
+
+    # Get analytics for a specific domain
+    # @param domain_id [String] The domain ID
+    # @param query [Hash] Query parameters
+    # @option query [Integer] :days Number of days to retrieve (optional)
+    # @option query [String] :startDate Start date for analytics (ISO 8601)
+    # @option query [String] :endDate End date for analytics (ISO 8601)
+    # @return [Array] Response data and error
+    def get_analytics(domain_id, query = {})
+      params = []
+      params << "days=#{query[:days]}" if query[:days]
+      params << "startDate=#{query[:startDate]}" if query[:startDate]
+      params << "endDate=#{query[:endDate]}" if query[:endDate]
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/domains/#{domain_id}/analytics#{query_string}")
+    end
+
+    # Get stats for a specific domain
+    # @param domain_id [String] The domain ID
+    # @param query [Hash] Query parameters
+    # @option query [Integer] :days Number of days to retrieve (optional)
+    # @option query [String] :startDate Start date for stats (ISO 8601)
+    # @option query [String] :endDate End date for stats (ISO 8601)
+    # @return [Array] Response data and error
+    def get_stats(domain_id, query = {})
+      params = []
+      params << "days=#{query[:days]}" if query[:days]
+      params << "startDate=#{query[:startDate]}" if query[:startDate]
+      params << "endDate=#{query[:endDate]}" if query[:endDate]
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/domains/#{domain_id}/stats#{query_string}")
+    end
   end
 end

data/lib/unsent/emails.rb

@@ -100,5 +100,20 @@ module Unsent
       query_string = params.empty? ? '' : "?#{params.join('&')}"
       @client.get("/emails/unsubscribes#{query_string}")
     end
+
+    # Get events for a specific email
+    # @param email_id [String] The email ID
+    # @param query [Hash] Query parameters
+    # @option query [Integer] :page Page number (default: 1)
+    # @option query [Integer] :limit Number of items per page (default: 50, max: 100)
+    # @return [Array] Response data and error
+    def get_events(email_id, query = {})
+      params = []
+      params << "page=#{query[:page]}" if query[:page]
+      params << "limit=#{query[:limit]}" if query[:limit]
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/emails/#{email_id}/events#{query_string}")
+    end
   end
 end

data/lib/unsent/events.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Unsent
+  class Events
+    def initialize(client)
+      @client = client
+    end
+
+    # Retrieve all email events
+    # @param query [Hash] Query parameters
+    # @option query [Integer] :page Page number (default: 1)
+    # @option query [Integer] :limit Number of items per page (default: 50, max: 100)
+    # @option query [String] :status Filter by event status
+    # @option query [String] :startDate Filter events from this date (ISO 8601)
+    # @return [Array] Response data and error
+    def list(query = {})
+      params = []
+      params << "page=#{query[:page]}" if query[:page]
+      params << "limit=#{query[:limit]}" if query[:limit]
+      params << "status=#{query[:status]}" if query[:status]
+      params << "startDate=#{query[:startDate]}" if query[:startDate]
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/events#{query_string}")
+    end
+  end
+end

data/lib/unsent/metrics.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Unsent
+  class Metrics
+    def initialize(client)
+      @client = client
+    end
+
+    # Retrieve metrics data
+    # @param query [Hash] Query parameters
+    # @option query [Integer] :page Page number (default: 1)
+    # @option query [Integer] :limit Number of items per page (default: 50, max: 100)
+    # @return [Array] Response data and error
+    def get(query = {})
+      params = []
+      params << "page=#{query[:page]}" if query[:page]
+      params << "limit=#{query[:limit]}" if query[:limit]
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/metrics#{query_string}")
+    end
+  end
+end

data/lib/unsent/stats.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Unsent
+  class Stats
+    def initialize(client)
+      @client = client
+    end
+
+    # Retrieve statistics data
+    # @param query [Hash] Query parameters
+    # @option query [Integer] :page Page number (default: 1)
+    # @option query [Integer] :limit Number of items per page (default: 50, max: 100)
+    # @return [Array] Response data and error
+    def get(query = {})
+      params = []
+      params << "page=#{query[:page]}" if query[:page]
+      params << "limit=#{query[:limit]}" if query[:limit]
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/stats#{query_string}")
+    end
+  end
+end

data/lib/unsent/system.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Unsent
+  class System
+    def initialize(client)
+      @client = client
+    end
+
+    # Check if the API is running correctly
+    # @return [Array] Response data and error
+    def health
+      @client.get('/health')
+    end
+
+    # Retrieve API version information
+    # @return [Array] Response data and error
+    def version
+      @client.get('/version')
+    end
+  end
+end

data/lib/unsent/teams.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Unsent
+  class Teams
+    def initialize(client)
+      @client = client
+    end
+
+    # List all teams
+    # @return [Array] Response data and error
+    def list
+      @client.get('/teams')
+    end
+
+    # Get a specific team by ID
+    # @param team_id [String] The team ID
+    # @return [Array] Response data and error
+    def get(team_id)
+      @client.get("/teams/#{team_id}")
+    end
+  end
+end