braze_ruby 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8cd9bb68fd35c0ccd7a9ecae5c5231696f2a48e906cea65f4436d7383167916
-  data.tar.gz: 54c80de739f86eaf92321a6ff2a2fae377e17c2915427ea614e242547debd32a
+  metadata.gz: c00945c683cf1036e050a2268b6b79b8cde870b94a0e81de114a40088b4993c8
+  data.tar.gz: b96dacd6c85d3fe8aa3584f98e21f9876a1fbfa97120da01f410d8dcaf31826e
 SHA512:
-  metadata.gz: 8862330d38a1b209bcb0afcb4ad11140e91c76cb3d4070010ed39f8272c3a21834412e5d41945e2e5a0e1ed8bc162e6ef75d92933e5e16b7cb1960e7bf1ff0ed
-  data.tar.gz: 6df0f44bc9e59531234a465384eb2ad7996abf43329f84aa0efff5714c980269277e83f464e0b6e33a54fc2ef6753e66d48110f34dbda8e4fa0bb203c024de39
+  metadata.gz: 3ac7068ab004e42ec49d1e222ff945af8899d7b43a0bae95f9d93fa4a2d2873a3fb19236d1f5984b86c48c833f6d6ae6ce80d81fd061403709a11b2d7d34636b
+  data.tar.gz: d5ad50ff9090f009d1c461819f7c2d9327f37789720f26e21158a0e1b4178ea3aa3c4089b97be8940a45207cfc92a7193323f7214a83e8679002e84783cc4fc6

data/.circleci/config.yml

@@ -0,0 +1,26 @@
+version: 2.1
+jobs:
+  test:
+    parameters:
+      ruby-version:
+        type: string
+    docker:
+      - image: << parameters.ruby-version >>
+    steps:
+      - checkout
+      - run:
+          name: Gem install bundler
+          command: gem update --system && gem install bundler
+      - run:
+          name: Bundle install
+          command: bundle install --jobs=4 --retry=3 --path vendor/bundle
+      - run:
+          name: Run tests
+          command: bundle exec rake
+workflows:
+  all-tests:
+    jobs:
+      - test:
+          matrix:
+            parameters:
+              ruby-version: ["ruby:3.0.1", "ruby:2.7.3", "ruby:2.6.7"]

data/.github/workflows/gem_credentials

@@ -0,0 +1,2 @@
+---
+:rubygems_api_key: REPLACE_ME

data/.github/workflows/release.yml

@@ -0,0 +1,20 @@
+name: release
+on:
+  push:
+    tags:
+      - v*
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup rubygems
+        run: |
+          mkdir ~/.gem
+          cp ./.github/workflows/gem_credentials ~/.gem/credentials
+          chmod 0600 ~/.gem/credentials
+          sed -i "s/REPLACE_ME/${{ secrets.RUBYGEMS_KEY }}/g" ~/.gem/credentials
+      - name: Build gem
+        run: gem build braze_ruby.gemspec --output braze_ruby.gem
+      - name: Publish gem
+        run: gem push braze_ruby.gem

data/.gitignore

@@ -1,19 +1,12 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-.ruby-version
-.ruby-gemset
-.env
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+Gemfile.lock
+
+# rspec failure tracking
+.rspec_status

data/.standard.yml

@@ -0,0 +1 @@
+format: progress

data/Gemfile

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

data/LICENSE.txt

@@ -1,22 +1,21 @@
-Copyright (c) 2014 Josh Nussbaum
+The MIT License (MIT)
 
-MIT License
+Copyright (c) 2021 Jon Allured
 
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -1,4 +1,4 @@
-# BrazeRuby
+# BrazeRuby [![CircleCI][badge]][circle]
 
 A wrapper for the Braze REST API. Forked from https://github.com/DynamoMTL/appboy
 
@@ -187,7 +187,20 @@ api.subscription_status_set(
 )
 ```
 
-### User Identification
+### User Alias
+
+#### Create an alias-only user
+
+```ruby
+api.create_user_aliases(
+  user_aliases: [{
+    user_alias: {
+      alias_name: "device123",
+      alias_label: "my_device_identifier",
+    }
+  }]
+)
+```
 
 #### Identify an alias-only user
 ```ruby
@@ -202,6 +215,42 @@ api.identify_users(
 )
 ```
 
+### External ID Migration
+
+#### Rename users' external IDs with an array of external_id_renames
+Note: you can send up to 50 rename objects per request.
+```ruby
+api.rename_external_ids(
+  external_id_renames: [{
+    current_external_id: "old_external_id",
+    new_external_id: "new_external_id",
+  }]
+)
+```
+
+#### Remove users' old deprecated external IDs
+Note: you can send up to 50 external IDs per request.
+```ruby
+api.remove_external_ids(external_ids: ['old_external_id'])
+```
+
+### Email Sync
+
+#### Get List of or Query Email Unsubscribes
+```ruby
+api.email_unsubscribes(email: ['jdoe@example.com'])
+```
+
+#### Get List of or Query Hard Bounced Emails
+```ruby
+api.email_hard_bounces(email: ['jdoe@example.com'])
+```
+
+#### Remove Email Addresses From Spam List
+```ruby
+api.remove_emails_from_spam(email: ['jdoe@example.com'])
+```
+
 ## Debugging
 
 The BRAZE_RUBY_DEBUG environment variable will trigger full printouts of the Faraday gem's HTTP requests and responses.
@@ -219,3 +268,6 @@ bundle exec rails whatever
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
+
+[badge]: https://circleci.com/gh/jonallured/braze_ruby.svg?style=svg
+[circle]: https://circleci.com/gh/jonallured/braze_ruby

data/Rakefile

@@ -2,6 +2,7 @@
 
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
+require "standard/rake"
 
 RSpec::Core::RakeTask.new(:spec)
-task default: :spec
+task default: %i[standard spec]

data/bin/release

@@ -0,0 +1,16 @@
+#! /bin/sh
+set -ex
+
+old_version=$1
+new_version=$2
+
+version_files="lib/braze_ruby/version.rb Gemfile.lock"
+commit_message="Bumping version numbers for $new_version"
+tag_message="Tagging version $new_version"
+
+sed -i "" "s/$old_version/$new_version/g" $version_files
+git add .
+git commit --message "$commit_message"
+git push origin main
+git tag --annotate v$new_version --message "$tag_message"
+git push origin --tags

data/braze_ruby.gemspec

@@ -1,38 +1,35 @@
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'braze_ruby/version'
+require_relative "lib/braze_ruby/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = 'braze_ruby'
-  spec.version       = BrazeRuby::VERSION
-  spec.authors       = ['Josh Nussbaum', 'Hugo Bastien', 'Justin Boltz']
-  spec.email         = %w(josh@godynamo.com hugo@godynamo.com justin.boltz@takl.com)
-  spec.description   = %q{Braze wrapper}
-  spec.summary       = %q{A wrapper for the Braze REST API forked from the appboy gem, track users/events/purchases, send & schedule messages}
-  spec.homepage      = 'https://www.braze.com/'
-  spec.license       = 'MIT'
+  spec.name = "braze_ruby"
+  spec.version = BrazeRuby::VERSION
+  spec.authors = ["Josh Nussbaum", "Hugo Bastien", "Justin Boltz", "Jonathan Allured"]
+  spec.email = %w[josh@godynamo.com hugo@godynamo.com justin.boltz@takl.com jon.allured@gmail.com]
 
-  if spec.respond_to?(:metadata)
-    spec.metadata["homepage_uri"] = spec.homepage
-    spec.metadata["source_code_uri"] = "https://github.com/jboltz88/braze_ruby"
-  else
-    raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
-  end
+  spec.summary = "A wrapper gem for the Braze REST API."
+  spec.description = "Wrapper for Braze API"
+  spec.homepage = "https://github.com/jonallured/braze_ruby"
+  spec.license = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
 
-  spec.files         = `git ls-files`.split($/)
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ['lib']
-  spec.required_ruby_version = '>= 2.0'
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
 
-  spec.add_dependency 'faraday'
+  spec.add_dependency "faraday"
 
-  spec.add_development_dependency 'bundler', '>= 1.3'
-  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'
+  spec.add_development_dependency "dotenv"
+  spec.add_development_dependency "factory_bot"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "standard"
+  spec.add_development_dependency "vcr"
+  spec.add_development_dependency "webmock"
 end

data/lib/braze_ruby.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require 'braze_ruby/version'
+require "braze_ruby/version"
 
 module BrazeRuby
-  autoload :API, 'braze_ruby/api'
-  autoload :REST, 'braze_ruby/rest'
-  autoload :Endpoints, 'braze_ruby/endpoints'
+  autoload :API, "braze_ruby/api"
+  autoload :REST, "braze_ruby/rest"
+  autoload :Endpoints, "braze_ruby/endpoints"
 end

data/lib/braze_ruby/api.rb

@@ -1,15 +1,18 @@
 # frozen_string_literal: true
 
-require 'braze_ruby/deprecated'
-require 'braze_ruby/endpoints/track_users'
-require 'braze_ruby/endpoints/send_messages'
-require 'braze_ruby/endpoints/schedule_messages'
-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'
+require "braze_ruby/deprecated"
+require "braze_ruby/endpoints/track_users"
+require "braze_ruby/endpoints/send_messages"
+require "braze_ruby/endpoints/schedule_messages"
+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"
+require "braze_ruby/endpoints/rename_external_ids"
+require "braze_ruby/endpoints/remove_external_ids"
+require "braze_ruby/endpoints/remove_email_addresses_from_spam"
 
 module BrazeRuby
   class API
@@ -25,6 +28,10 @@ module BrazeRuby
     include BrazeRuby::Endpoints::Canvas
     include BrazeRuby::Endpoints::Subscription
     include BrazeRuby::Endpoints::IdentifyUsers
+    include BrazeRuby::Endpoints::CreateUserAliases
+    include BrazeRuby::Endpoints::RenameExternalIds
+    include BrazeRuby::Endpoints::RemoveExternalIds
+    include BrazeRuby::Endpoints::RemoveEmailAddressesFromSpam
 
     def export_users(**payload)
       BrazeRuby::REST::ExportUsers.new(api_key, braze_url, options).perform(**payload)

data/lib/braze_ruby/deprecated.rb

@@ -3,19 +3,18 @@
 module BrazeRuby
   module Deprecated
     def track(attribute, events = [], purchases = [])
-      warn('[BrazeRuby] `track` is deprecated. Please use `track_users` instead.')
+      warn("[BrazeRuby] `track` is deprecated. Please use `track_users` instead.")
       track_users(attribute: attribute, events: events, purchases: purchases)
     end
 
     def send_message(message, user_ids, segment_ids = nil)
-      warn('[BrazeRuby] `send_message` is deprecated. Please use `send_messages` instead.')
+      warn("[BrazeRuby] `send_message` is deprecated. Please use `send_messages` instead.")
       send_messages(messages: message, user_ids: user_ids, segment_ids: segment_ids)
     end
 
     def schedule_message(date, message, segment_id, local_timezone = false)
-      warn('[BrazeRuby] `schedule_message` is deprecated. Please use `schedule_messages` instead.')
-      schedule_messages(send_at: date, messages: message,
-        segment_id: segment_id, local_timezone: local_timezone)
+      warn("[BrazeRuby] `schedule_message` is deprecated. Please use `schedule_messages` instead.")
+      schedule_messages(send_at: date, messages: message, segment_id: segment_id, local_timezone: local_timezone)
     end
   end
 end

data/lib/braze_ruby/endpoints.rb

@@ -1,9 +1,13 @@
 # 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'
+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"
+require "braze_ruby/endpoints/create_user_aliases"
+require "braze_ruby/endpoints/rename_external_ids"
+require "braze_ruby/endpoints/remove_external_ids"
+require "braze_ruby/endpoints/remove_email_addresses_from_spam"

data/lib/braze_ruby/endpoints/create_user_aliases.rb

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