unsent 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3654dd5977b62530b4cde2e028eb70aa08a29dbc09c0ff41d59127a831c61db0
-  data.tar.gz: d90d594fdb4db827a8cffc65f8373f53d1ccb4bf6e11e580da858a6689271775
+  metadata.gz: aa505d7132d95fc8d1d1081eacdc6dc1c152d7265775437c7841a63f0cfbab0b
+  data.tar.gz: d173d3f42bb1b159f2a4d59070d7f1c6db41bb8af2771c29d1808f742541394a
 SHA512:
-  metadata.gz: f32d82928ae27864e81968b6d95e508e1c5ffc0eb8601a9456ea73f7be70fee4292e7fc134b0c5a8c2db774ea4babddcf90e67a91773c8ec2a43ba8a71e7d212
-  data.tar.gz: 97a1c68b5e3845cc052c863e6cbdcc1b5203adb187c801106c37c3ea70bfb6e81d970a25eaa5122726732b6150e721805da1c1f2f1d8396decebd291e1fcb454
+  metadata.gz: 22ae152f36d21cc5f7dda582594d1b0cb0e667fba6765e9dbf3e14f23e9cf2f65f15f4ff937a09a36303d04d0d4208c5dfd5aa31121bd6c86b759dbc6a40dffd
+  data.tar.gz: 12f06ce781b6c75e5cc7985bd9eaa5dd1f48754715a0115cca022ed3467de14daf716284a373d17a2ea7d8beb7cb5d661b5c8b95ecf5ef0b6be18efd2daec831

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2025 TODO: Write your name
+Copyright (c) 2025 Sourav Ukil
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -35,7 +35,7 @@ gem install unsent
 ```ruby
 require 'unsent'
 
-client = Unsent::Client.new('us_xxx')
+client = Unsent::Client.new('un_xxx')
 ```
 
 ### Environment Variables
@@ -267,7 +267,7 @@ end
 To handle errors as return values instead:
 
 ```ruby
-client = Unsent::Client.new('us_xxx', raise_on_error: false)
+client = Unsent::Client.new('un_xxx', raise_on_error: false)
 
 data, error = client.emails.get('email_123')
 if error
@@ -277,6 +277,262 @@ else
 end
 ```
 
+## Email Management
+
+### List Emails
+
+Retrieve a paginated list of emails with optional filters:
+
+```ruby
+data, error = client.emails.list(
+  page: 1,
+  limit: 10,
+  startDate: '2024-01-01',
+  endDate: '2024-01-31',
+  domainId: 'domain_123'
+)
+
+# Support for multiple domain IDs
+data, error = client.emails.list(domainId: ['domain_1', 'domain_2'])
+```
+
+### Email Statistics
+
+```ruby
+# Get complaints
+data, error = client.emails.get_complaints(page: 1, limit: 10)
+
+# Get bounces
+data, error = client.emails.get_bounces(page: 1, limit: 10)
+
+# Get unsubscribes
+data, error = client.emails.get_unsubscribes(page: 1, limit: 10)
+```
+
+## Contact Books
+
+Organize your contacts into separate books.
+
+### Create Contact Book
+
+```ruby
+data, error = client.contact_books.create(
+  name: 'Newsletter Subscribers',
+  emoji: '📧'
+)
+```
+
+### List Contact Books
+
+```ruby
+books, error = client.contact_books.list
+books.each { |book| puts book['name'] }
+```
+
+### Get Contact Book
+
+```ruby
+book, error = client.contact_books.get('book_123')
+```
+
+### Update Contact Book
+
+```ruby
+data, error = client.contact_books.update('book_123', name: 'Updated Name')
+```
+
+### Delete Contact Book
+
+```ruby
+data, error = client.contact_books.delete('book_123')
+```
+
+## Contacts
+
+### List Contacts
+
+```ruby
+data, error = client.contacts.list('book_123',
+  page: 1,
+  limit: 10,
+  search: 'john@example.com'
+)
+```
+
+## Campaigns
+
+### List Campaigns
+
+```ruby
+campaigns, error = client.campaigns.list
+```
+
+## Analytics
+
+Get insights into your email sending performance.
+
+### Overall Analytics
+
+```ruby
+data, error = client.analytics.get
+puts "Sent: #{data['sent']}, Delivered: #{data['delivered']}"
+```
+
+### Time Series Data
+
+```ruby
+data, error = client.analytics.get_time_series(
+  days: 30,
+  domain: 'yourdomain.com'
+)
+```
+
+### Reputation Score
+
+```ruby
+data, error = client.analytics.get_reputation(domain: 'yourdomain.com')
+puts "Reputation Score: #{data['score']}"
+```
+
+## Templates
+
+Manage reusable email templates.
+
+### Create Template
+
+```ruby
+data, error = client.templates.create(
+  name: 'Welcome Email',
+  subject: 'Welcome to {{companyName}}!',
+  html: '<h1>Welcome {{firstName}}!</h1>'
+)
+```
+
+### List Templates
+
+```ruby
+templates, error = client.templates.list
+```
+
+### Get Template
+
+```ruby
+template, error = client.templates.get('template_123')
+```
+
+### Update Template
+
+```ruby
+data, error = client.templates.update('template_123',
+  subject: 'Updated Subject'
+)
+```
+
+### Delete Template
+
+```ruby
+data, error = client.templates.delete('template_123')
+```
+
+## Suppressions
+
+Manage your email suppression list.
+
+### List Suppressions
+
+```ruby
+data, error = client.suppressions.list(
+  page: 1,
+  limit: 10,
+  reason: 'MANUAL',
+  search: 'user@'
+)
+```
+
+### Add to Suppression List
+
+```ruby
+data, error = client.suppressions.add(
+  email: 'blocked@example.com',
+  reason: 'MANUAL'
+)
+```
+
+### Remove from Suppression List
+
+```ruby
+data, error = client.suppressions.delete('blocked@example.com')
+```
+
+## API Keys
+
+Manage your API keys programmatically.
+
+### List API Keys
+
+```ruby
+keys, error = client.api_keys.list
+```
+
+### Create API Key
+
+```ruby
+data, error = client.api_keys.create(
+  name: 'Production Key',
+  permission: 'SENDING'
+)
+puts "New key: #{data['key']}"
+```
+
+### Delete API Key
+
+```ruby
+data, error = client.api_keys.delete('key_123')
+```
+
+## Webhooks
+
+> **Note**: Webhooks are currently a future feature and are documented here for reference.
+
+Configure webhooks to receive real-time notifications.
+
+### List Webhooks
+
+```ruby
+webhooks, error = client.webhooks.list
+```
+
+### Create Webhook
+
+```ruby
+data, error = client.webhooks.create(
+  url: 'https://yourdomain.com/webhooks',
+  events: ['email.sent', 'email.delivered', 'email.bounced']
+)
+```
+
+### Update Webhook
+
+```ruby
+data, error = client.webhooks.update('webhook_123',
+  url: 'https://yourdomain.com/updated-webhook'
+)
+```
+
+### Delete Webhook
+
+```ruby
+data, error = client.webhooks.delete('webhook_123')
+```
+
+## Settings
+
+Retrieve account settings.
+
+```ruby
+settings, error = client.settings.get
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.

data/lib/unsent/analytics.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Unsent
+  class Analytics
+    def initialize(client)
+      @client = client
+    end
+
+    def get
+      @client.get('/analytics')
+    end
+
+    def get_time_series(query = {})
+      params = []
+      params << "days=#{query[:days]}" if query[:days]
+      params << "domain=#{query[:domain]}" if query[:domain]
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/analytics/time-series#{query_string}")
+    end
+
+    def get_reputation(query = {})
+      params = []
+      params << "domain=#{query[:domain]}" if query[:domain]
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/analytics/reputation#{query_string}")
+    end
+  end
+end

data/lib/unsent/api_keys.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Unsent
+  class ApiKeys
+    def initialize(client)
+      @client = client
+    end
+
+    def list
+      @client.get('/api-keys')
+    end
+
+    def create(payload)
+      @client.post('/api-keys', payload)
+    end
+
+    def delete(id)
+      @client.delete("/api-keys/#{id}")
+    end
+  end
+end

data/lib/unsent/campaigns.rb

@@ -6,6 +6,10 @@ module Unsent
       @client = client
     end
 
+    def list
+      @client.get('/campaigns')
+    end
+
     def create(payload)
       @client.post("/campaigns", payload)
     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
+    attr_accessor :emails, :contacts, :campaigns, :domains, :analytics, :api_keys, :contact_books, :settings, :suppressions, :templates, :webhooks
 
     def initialize(key = nil, url: nil, raise_on_error: true)
       @key = key || ENV["UNSENT_API_KEY"] || ENV["UNSENT_API_KEY"]
@@ -24,6 +24,13 @@ module Unsent
       @contacts = Contacts.new(self)
       @campaigns = Campaigns.new(self)
       @domains = Domains.new(self)
+      @analytics = Analytics.new(self)
+      @api_keys = ApiKeys.new(self)
+      @contact_books = ContactBooks.new(self)
+      @settings = Settings.new(self)
+      @suppressions = Suppressions.new(self)
+      @templates = Templates.new(self)
+      @webhooks = Webhooks.new(self)
     end
 
     def request(method, path, body = nil, headers = {})

data/lib/unsent/contact_books.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Unsent
+  class ContactBooks
+    def initialize(client)
+      @client = client
+    end
+
+    def list
+      @client.get('/contactBooks')
+    end
+
+    def create(payload)
+      @client.post('/contactBooks', payload)
+    end
+
+    def get(id)
+      @client.get("/contactBooks/#{id}")
+    end
+
+    def update(id, payload)
+      @client.patch("/contactBooks/#{id}", payload)
+    end
+
+    def delete(id)
+      @client.delete("/contactBooks/#{id}")
+    end
+  end
+end

data/lib/unsent/contacts.rb

@@ -6,6 +6,17 @@ module Unsent
       @client = client
     end
 
+    def list(book_id, query = {})
+      params = []
+      params << "emails=#{query[:emails]}" if query[:emails]
+      params << "page=#{query[:page]}" if query[:page]
+      params << "limit=#{query[:limit]}" if query[:limit]
+      params << "ids=#{query[:ids]}" if query[:ids]
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/contactBooks/#{book_id}/contacts#{query_string}")
+    end
+
     def create(book_id, payload)
       @client.post("/contactBooks/#{book_id}/contacts", payload)
     end

data/lib/unsent/emails.rb

@@ -53,5 +53,52 @@ module Unsent
     def cancel(email_id)
       @client.post("/emails/#{email_id}/cancel", {})
     end
+
+    def list(query = {})
+      params = []
+      params << "page=#{query[:page]}" if query[:page]
+      params << "limit=#{query[:limit]}" if query[:limit]
+      params << "startDate=#{query[:startDate]}" if query[:startDate]
+      params << "endDate=#{query[:endDate]}" if query[:endDate]
+      
+      # Handle domainId as both string and array
+      if query[:domainId]
+        if query[:domainId].is_a?(Array)
+          query[:domainId].each { |id| params << "domainId=#{id}" }
+        else
+          params << "domainId=#{query[:domainId]}"
+        end
+      end
+      
+      query_string = params.empty? ? '' : "?#{params.join('&')}"
+      @client.get("/emails#{query_string}")
+    end
+
+    def get_complaints(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/complaints#{query_string}")
+    end
+
+    def get_bounces(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/bounces#{query_string}")
+    end
+
+    def get_unsubscribes(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/unsubscribes#{query_string}")
+    end
   end
 end

data/lib/unsent/errors.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 module Unsent
+  class Error < StandardError; end
+
   class HTTPError < Error
     attr_reader :status_code, :error, :method, :path