braze_ruby 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5649f519796cde810f2c2e2028c5a14fbcdfc7c6d93cf33043068fb4195b481
-  data.tar.gz: b81d2eed4f84937c0bd4721318c2474f36e987d97418961fb407744dcee068fb
+  metadata.gz: c8cd9bb68fd35c0ccd7a9ecae5c5231696f2a48e906cea65f4436d7383167916
+  data.tar.gz: 54c80de739f86eaf92321a6ff2a2fae377e17c2915427ea614e242547debd32a
 SHA512:
-  metadata.gz: 766e1d5e83222af37ba40d6e1333ea6e350b4e9ae327e943a31dfc60772253368a67fe8048b5ef72681759ce8e1ab13a7bdeb6c77fe92c82f167094881c22830
-  data.tar.gz: a1011b8b5f84bba75a5eae4bb1535d0582788ea10ef838b6821912a05dad3f3abc06bc4033a93004c3554b05ca949d74f40916caa4115f2dc9087cf066f418bf
+  metadata.gz: 8862330d38a1b209bcb0afcb4ad11140e91c76cb3d4070010ed39f8272c3a21834412e5d41945e2e5a0e1ed8bc162e6ef75d92933e5e16b7cb1960e7bf1ff0ed
+  data.tar.gz: 6df0f44bc9e59531234a465384eb2ad7996abf43329f84aa0efff5714c980269277e83f464e0b6e33a54fc2ef6753e66d48110f34dbda8e4fa0bb203c024de39

data/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 2.6
+
+    - name: Cache gems
+      uses: actions/cache@v1
+      with:
+        path: vendor/bundle
+        key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-gems-
+
+    - name: Build and test
+      run: |
+        gem install bundler
+        bundle config path vendor/bundle
+        bundle install --jobs 4 --retry 3
+        bundle exec rake spec

data/.gitignore

@@ -4,6 +4,7 @@
 .config
 .yardoc
 .ruby-version
+.ruby-gemset
 .env
 InstalledFiles
 _yardoc

data/Gemfile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 # Specify your gem's dependencies in braze_ruby.gemspec

data/Gemfile.lock

@@ -1,64 +1,64 @@
 PATH
   remote: .
   specs:
-    braze_ruby (0.2.1)
+    braze_ruby (0.4.0)
       faraday
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.0)
+    activesupport (6.0.3.2)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-      zeitwerk (~> 2.1, >= 2.1.8)
+      zeitwerk (~> 2.2, >= 2.2.2)
     addressable (2.7.0)
       public_suffix (>= 2.0.2, < 5.0)
-    coderay (1.1.2)
-    concurrent-ruby (1.1.5)
+    coderay (1.1.3)
+    concurrent-ruby (1.1.6)
     crack (0.4.3)
       safe_yaml (~> 1.0.0)
     diff-lcs (1.3)
     dotenv (2.7.5)
-    factory_bot (5.0.2)
+    factory_bot (5.2.0)
       activesupport (>= 4.2.0)
-    faraday (0.15.4)
+    faraday (1.0.1)
       multipart-post (>= 1.2, < 3)
-    hashdiff (1.0.0)
-    i18n (1.6.0)
+    hashdiff (1.0.1)
+    i18n (1.8.3)
       concurrent-ruby (~> 1.0)
-    method_source (0.9.2)
-    minitest (5.11.3)
+    method_source (1.0.0)
+    minitest (5.14.1)
     multipart-post (2.1.1)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    public_suffix (4.0.1)
-    rake (12.3.3)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.2)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.4)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    public_suffix (4.0.5)
+    rake (13.0.1)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.2)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.1)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.2)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.3)
     safe_yaml (1.0.5)
     thread_safe (0.3.6)
-    tzinfo (1.2.5)
+    tzinfo (1.2.7)
       thread_safe (~> 0.1)
-    vcr (5.0.0)
-    webmock (3.7.1)
+    vcr (6.0.0)
+    webmock (3.8.3)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    zeitwerk (2.1.9)
+    zeitwerk (2.3.0)
 
 PLATFORMS
   ruby
@@ -66,13 +66,13 @@ PLATFORMS
 DEPENDENCIES
   braze_ruby!
   bundler (>= 1.3)
-  dotenv
-  factory_bot
-  pry
-  rake
-  rspec
-  vcr
-  webmock
+  dotenv (~> 2.7.5)
+  factory_bot (>= 5.1.0)
+  pry (>= 0.12.2)
+  rake (>= 12.3.3)
+  rspec (~> 3.8)
+  vcr (>= 5.0.0)
+  webmock (>= 3.7.5)
 
 BUNDLED WITH
-   2.0.2
+   2.1.4

data/README.md

@@ -121,6 +121,15 @@ api.trigger_campaign_send(
 )
 ```
 
+### Send Canvas
+
+```ruby
+api.trigger_canvas_send(
+  canvas_id: 'canvas-id',
+  recipients: [external_user_id: 123, canvas_entry_properties: {first_name: 'John'}]
+)
+```
+
 ### Changing Email Subscription
 
 ```ruby
@@ -154,6 +163,45 @@ Delete Braze Users with an array of external_ids
 api.delete_users([1, 2, 3])
 ```
 
+### Subscription groups
+
+#### Get subscription group status for users by id
+```ruby
+api.subscription_user_status(external_id: [1])
+```
+
+#### Get users status for a specific subscription group
+```ruby
+api.subscription_status_get(
+  external_id: [1],
+  subscription_group_id: 'some-uuid'
+)
+```
+
+#### Set user status for a specific subscription group
+```ruby
+api.subscription_status_set(
+  external_id: [1],
+  subscription_group_id: 'some-uuid',
+  subscription_state: 'subscribed|unsubscribed'
+)
+```
+
+### User Identification
+
+#### Identify an alias-only user
+```ruby
+api.identify_users(
+  aliases_to_identify: [{
+    external_id: 1234,
+    user_alias: {
+      alias_name: "device123",
+      alias_label: "my_device_identifier",
+    }
+  }]
+)
+```
+
 ## Debugging
 
 The BRAZE_RUBY_DEBUG environment variable will trigger full printouts of the Faraday gem's HTTP requests and responses.

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 

data/braze_ruby.gemspec

@@ -28,11 +28,11 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'faraday'
 
   spec.add_development_dependency 'bundler', '>= 1.3'
-  spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rspec'
-  spec.add_development_dependency 'dotenv'
-  spec.add_development_dependency 'vcr'
-  spec.add_development_dependency 'webmock'
-  spec.add_development_dependency 'pry'
-  spec.add_development_dependency 'factory_bot'
+  spec.add_development_dependency 'rake', '>= 12.3.3'
+  spec.add_development_dependency 'rspec', '~> 3.8'
+  spec.add_development_dependency 'dotenv', '~> 2.7.5'
+  spec.add_development_dependency 'vcr', '>= 5.0.0'
+  spec.add_development_dependency 'webmock', '>= 3.7.5'
+  spec.add_development_dependency 'pry', '>= 0.12.2'
+  spec.add_development_dependency 'factory_bot', '>= 5.1.0'
 end

data/lib/braze_ruby.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'braze_ruby/version'
 
 module BrazeRuby

data/lib/braze_ruby/api.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'braze_ruby/deprecated'
 require 'braze_ruby/endpoints/track_users'
 require 'braze_ruby/endpoints/send_messages'
@@ -6,6 +8,8 @@ require 'braze_ruby/endpoints/email_status'
 require 'braze_ruby/endpoints/email_sync'
 require 'braze_ruby/endpoints/delete_users'
 require 'braze_ruby/endpoints/campaigns'
+require 'braze_ruby/endpoints/canvas'
+require 'braze_ruby/endpoints/subscription'
 
 module BrazeRuby
   class API
@@ -18,20 +22,24 @@ module BrazeRuby
     include BrazeRuby::Endpoints::EmailSync
     include BrazeRuby::Endpoints::DeleteUsers
     include BrazeRuby::Endpoints::Campaigns
+    include BrazeRuby::Endpoints::Canvas
+    include BrazeRuby::Endpoints::Subscription
+    include BrazeRuby::Endpoints::IdentifyUsers
 
     def export_users(**payload)
-      BrazeRuby::REST::ExportUsers.new(braze_url).perform(api_key, payload)
+      BrazeRuby::REST::ExportUsers.new(api_key, braze_url, options).perform(**payload)
     end
 
     def list_segments
-      BrazeRuby::REST::ListSegments.new(braze_url).perform(api_key)
+      BrazeRuby::REST::ListSegments.new(api_key, braze_url, options).perform
     end
 
-    attr_reader :api_key, :braze_url
+    attr_reader :api_key, :braze_url, :options
 
-    def initialize(api_key, braze_url)
+    def initialize(api_key, braze_url, options = {})
       @api_key = api_key
       @braze_url = braze_url
+      @options = options
     end
   end
 end

data/lib/braze_ruby/deprecated.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BrazeRuby
   module Deprecated
     def track(attribute, events = [], purchases = [])

data/lib/braze_ruby/endpoints.rb

@@ -1,6 +1,9 @@
+# frozen_string_literal: true
+
 require 'braze_ruby/endpoints/email_status'
 require 'braze_ruby/endpoints/email_sync'
 require 'braze_ruby/endpoints/schedule_messages'
 require 'braze_ruby/endpoints/send_messages'
 require 'braze_ruby/endpoints/track_users'
 require 'braze_ruby/endpoints/delete_users'
+require 'braze_ruby/endpoints/identify_users'

data/lib/braze_ruby/endpoints/campaigns.rb

@@ -1,8 +1,10 @@
+# frozen_string_literal: true
+
 module BrazeRuby
   module Endpoints
     module Campaigns
       def trigger_campaign_send(**payload)
-        BrazeRuby::REST::TriggerCampaignSend.new(api_key, braze_url, payload).perform
+        BrazeRuby::REST::TriggerCampaignSend.new(api_key, braze_url, options, **payload).perform
       end
     end
   end

data/lib/braze_ruby/endpoints/canvas.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module BrazeRuby
+  module Endpoints
+    module Canvas
+      def trigger_canvas_send(**payload)
+        BrazeRuby::REST::TriggerCanvasSend.new(api_key, braze_url, options, **payload).perform
+      end
+
+      def canvas_details(**payload)
+        BrazeRuby::REST::CanvasDetails.new(api_key, braze_url, options, **payload).perform
+      end
+    end
+  end
+end

data/lib/braze_ruby/endpoints/delete_users.rb

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 module BrazeRuby
   module Endpoints
     module DeleteUsers
       attr_writer :delete_users_service
 
       def delete_users_action(**payload)
-        delete_users_service.perform(api_key, payload)
+        delete_users_service.perform(**payload)
       end
 
       def delete_users(payload)
@@ -14,7 +16,7 @@ module BrazeRuby
       private
 
       def delete_users_service
-        @delete_users_service ||= BrazeRuby::REST::DeleteUsers.new(braze_url)
+        @delete_users_service ||= BrazeRuby::REST::DeleteUsers.new(api_key, braze_url, options)
       end
     end
   end

data/lib/braze_ruby/endpoints/email_status.rb

@@ -1,8 +1,10 @@
+# frozen_string_literal: true
+
 module BrazeRuby
   module Endpoints
     module EmailStatus
       def email_status(**payload)
-        email_status_service.new(api_key, braze_url, payload).perform
+        email_status_service.new(api_key, braze_url, options, **payload).perform
       end
 
       def email_status_service

data/lib/braze_ruby/endpoints/email_sync.rb

@@ -1,12 +1,14 @@
+# frozen_string_literal: true
+
 module BrazeRuby
   module Endpoints
     module EmailSync
       def email_unsubscribes(**payload)
-        BrazeRuby::REST::EmailUnsubscribes.new(api_key, braze_url, payload).perform
+        BrazeRuby::REST::EmailUnsubscribes.new(api_key, braze_url, options, **payload).perform
       end
 
       def email_hard_bounces(**payload)
-        BrazeRuby::REST::EmailHardBounces.new(api_key, braze_url, payload).perform
+        BrazeRuby::REST::EmailHardBounces.new(api_key, braze_url, options, **payload).perform
       end
     end
   end

data/lib/braze_ruby/endpoints/identify_users.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module BrazeRuby
+  module Endpoints
+    module IdentifyUsers
+      attr_writer :identify_users_service
+
+      def identify_users(**payload)
+        identify_users_service.perform(**payload)
+      end
+
+      private
+
+      def identify_users_service
+        @identify_users_service ||= BrazeRuby::REST::IdentifyUsers.new(api_key, braze_url, options)
+      end
+    end
+  end
+end

data/lib/braze_ruby/endpoints/schedule_messages.rb

@@ -1,8 +1,10 @@
+# frozen_string_literal: true
+
 module BrazeRuby
   module Endpoints
     module ScheduleMessages
       def schedule_messages(**payload)
-        schedule_messages_service.new(api_key, braze_url, payload).perform
+        schedule_messages_service.new(api_key, braze_url, options, **payload).perform
       end
 
       private