iterable-api-client 0.3.2 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b456f80ce650910ada263cdb96b28a5fd188dd5afcc4aa44813e0b3892d5d946
-  data.tar.gz: 308c15224339eb8a859cf3d9f6491907595d58da5d8bcc46c3f8223ddd356660
+  metadata.gz: 003ee817aaa95dc181bf7b36909387689f70ffa1ed755878eb7132a0166b0130
+  data.tar.gz: 3ab136966f544fc25f2431d39a99ac84e94cf5f88c1d496f1dd7b4bd2e45cff2
 SHA512:
-  metadata.gz: 57c4ad6a3f16d3f7ab4b490bedf27b028f24f2ae1c1de9d79815740d3398d04aeffa0b42543de150a1bec6a988f3821f6f970605beb5da9a7a7890e95fcb49a2
-  data.tar.gz: ae76c13bcb47302c41ca6b4a763b6dd53b6669da101b53f927500c73584facd143c0dbbedd922baacfea6806b82f52da84f2c2592f3255d6e7fed580ad152c36
+  metadata.gz: d3696c057360e661ee4f632182323a9d99a8af4110be64fce1d1dfd58980c9a13d65dc1b0767df53f17502925526949e1fc17aadc980a4b654479a34a65009bc
+  data.tar.gz: 874f5d7201a038ddc54437e1d0920b3c0bf77f5d5333c5ccdcd5a756e20154d0942b0920c800669e2adb8ef0d3f65a62b66644a936ed25800bf59d26bd571a93

data/README.md

@@ -124,6 +124,7 @@ reponse.uri
   - [Upsert](#email-templates-upsert)
 - [Events](#events)
   - [For Email](#events-for-email)
+  - [Bulk Track](#events-track-bulk)
   - [Track](#events-track)
   - [Track Push Open](#events-track-push-open)
 - [Experiments](#experiments)
@@ -133,6 +134,8 @@ reponse.uri
   - [CSV](#export-csv)
 - [In App](#in-app)
   - [Messages](#in-app-messages)
+  - [Target](#in-app-target)
+  - [Cancel](#in-app-cancel)
 - [Lists](#lists)
   - [All](#lists-all)
   - [Create](#lists-create)
@@ -149,6 +152,9 @@ reponse.uri
   - [Get Key](#metadata-get-key)
   - [Remove Key](#metadata-remove-key)
   - [Add Key](#metadata-add-key)
+- [Push](#push)
+  - [Target](#push-target)
+  - [Cancel](#push-cancel)
 - [Push Templates](#push-templates)
   - [Get](#push-templates-get)
   - [Update](#push-templates-update)
@@ -300,7 +306,8 @@ Endpoint: `GET /catalogs/{catalogName}/fieldMappings`
 ```ruby
 catalog = 'my-catalog'
 catalog_field_mappings = Iterable::CatalogFieldMappings.new(catalog)
-response = catalog_field_mappings.field_mappings
+response = catalog_field_mappings.get
+response.body['params']['definedMappings']
 ```
 
 #### Catalog Field Mappings Update
@@ -557,6 +564,19 @@ attrs = { campaignId: 42, dataFields: {} }
 response = events.track 'event-name', 'user@example.com', attrs
 ```
 
+#### Events Track Bulk
+
+Endpoint: `POST /events/trackBulk`
+
+```ruby
+events = Iterable::Events.new
+# Array of events to track
+events_attrs = [
+  { email: 'user@example.com', eventName: 'event-name', campaignId: 42, dataFields: {} }
+]
+response = iterable_events.track_bulk events_attrs
+```
+
 #### Events Track Push Open
 
 Endpoint: `GET /events/{email}`
@@ -639,7 +659,34 @@ response = in_app.messages_for_user_id 42, count: 2
 # Pass in query parameters
 email = 'user@example.com'
 attrs = { 'platform' => 'iOS' }
-response = in_app.messages_for_email: email, attrs
+response = in_app.messages_for_email email, attrs
+```
+
+#### In App Target
+
+Endpoint: `POST /inApp/target`
+
+```ruby
+in_app = Iterable::InApp.new
+
+# Needs campaign ID and an optional email
+email = 'user@example.com'
+attrs = { 'campaignId' => '123456asdf' }
+response = in_app.target attrs: attrs, email: email
+```
+
+#### In App Cancel
+
+Endpoint: `POST /push/cancel`
+
+```ruby
+in_app = Iterable::InApp.new
+
+# Needs campaign ID and an optional email and optional attrs for request
+email = 'user@example.com'
+campaign_id = '12345asdf'
+attrs = {}
+response = in_app.target campaign_id: campaign_id, attrs: attrs, email: email
 ```
 
 ### Lists
@@ -776,6 +823,32 @@ value = { foo: 'bar', data: 'stuffs' }
 response = metadata_table.add 'metadata-key', value
 ```
 
+### Push
+
+#### Push Target
+
+Endpoint: `POST /push/target`
+
+```ruby
+push = Iterable::Push.new
+campaign_id = '1234asdf'
+email = 'user@example.com' # optional
+attrs = {} # optional extra params for the request
+response = push.target campaign_id: campaign_id, email: email, attrs: attrs
+```
+
+#### Push Cancel
+
+Endpoint: `POST /push/cancel`
+
+```ruby
+push = Iterable::Push.new
+campaign_id = '1234asdf'
+email = 'user@example.com' # optional
+attrs = {} # optional extra params for the request
+response = push.cancel email: email, campaign_id: campaign_id, attrs: attrs
+```
+
 ### Push Templates
 
 #### Push Templates Get
@@ -854,10 +927,10 @@ Endpoint: `POST /users/bulkUpdate`
 users = Iterable::Users.new
 # Array of users to update by email with additional
 # fields if needed
-users = [
+users_attrs = [
 	{ email: 'user@example.com', userID: 'custom-id' }
 ]
-response = users.bulk_update users
+response = users.bulk_update users_attrs
 ```
 
 #### Users Update Subscriptions

data/lib/iterable/catalog_field_mappings.rb

@@ -14,6 +14,7 @@ module Iterable
   #   catalog = Iterable::CatalogFieldMappings.new("catalog-name", config)
   class CatalogFieldMappings < ApiResource
     attr_reader :catalog
+
     ##
     #
     # Initialize CatalogFieldMappings with a catalog name **currently in Beta only**

data/lib/iterable/catalogs.rb

@@ -14,6 +14,7 @@ module Iterable
   #   catalog = Iterable::Catalogs.new("catalog-name", config)
   class Catalogs < ApiResource
     attr_reader :name
+
     ##
     #
     # Initialize Catalogs with a catalog name **currently in Beta only**

data/lib/iterable/events.rb

@@ -39,6 +39,19 @@ module Iterable
       Iterable.request(conf, '/events/track').post(attrs)
     end
 
+    ##
+    #
+    # Bulk Track events
+    #
+    # @param events [Array[Hash]] Array of hashes of event details
+    #
+    # @return [Iterable::Response] A response object
+    #
+    # @note Event fields can be eventName [String], email [String], dataFields [Hash], or userId [String]
+    def track_bulk(events = [])
+      Iterable.request(conf, '/events/trackBulk').post(events: events)
+    end
+
     ##
     #
     # Track an event

data/lib/iterable/experiments.rb

@@ -13,6 +13,7 @@ module Iterable
   #   templates = Iterable::Experiments.new([1, 2, 3], config)
   class Experiments < ApiResource
     attr_reader :experiment_ids
+
     ##
     #
     # Initialize Experiments with an array of experiment ids

data/lib/iterable/export.rb

@@ -57,7 +57,7 @@ module Iterable
     # @param conf [Iterable::Config] A config to optionally pass for requests
     #
     # @return [Iterable::Export]
-    def initialize(data_type, only_fields = [], omit_fields = [], campaign_id = nil, conf = nil)
+    def initialize(data_type, only_fields = [], omit_fields = [], campaign_id = nil, conf = nil) # rubocop:disable Metrics/ParameterLists
       @data_type = data_type
       @only_fields = only_fields
       @omit_fields = omit_fields

data/lib/iterable/in_app.rb

@@ -41,6 +41,42 @@ module Iterable
       messages(attrs)
     end
 
+    ##
+    #
+    # Send an In-App notification to a specific user. User Email or ID along
+    # with campaign ID must be provided
+    #
+    # @param email [String] (optional) User email used to identify user
+    # @param campaign_id [Integer] Campaign ID
+    # @param attrs [Hash] Additional data to update or add
+    #
+    # @return [Iterable::Response] A response object
+    #
+    def target(campaign_id:, attrs: {}, email: nil)
+      attrs['recipientEmail'] = email if email
+      attrs['campaignId'] = campaign_id
+      Iterable.request(conf, '/inApp/target').post(attrs)
+    end
+
+    ##
+    #
+    # Cancel an In App notification sent to a specific user
+    # Must include either an email address AND campaignId, or
+    # just a scheduledMessageId provided in the attrs
+    #
+    # @param email [String] User email to cancel push
+    # @param campaignId [Integer] campaignID used to cancel push
+    # @param attrs [Hash] Additional data to update or add
+    #
+    # @return [Iterable::Response] A response object
+    #
+    # @note An email or UserId is required
+    def cancel(campaign_id: nil, attrs: {}, email: nil)
+      attrs['email'] = email if email
+      attrs['campaignId'] = campaign_id if campaign_id
+      Iterable.request(conf, '/push/cancel').post(attrs)
+    end
+
     private def messages(**attrs)
       Iterable.request(conf, '/inApp/getMessages', attrs).get
     end

data/lib/iterable/metadata_table.rb

@@ -13,6 +13,7 @@ module Iterable
   #   templates = Iterable::MetadataTable.new("table-name", config)
   class MetadataTable < ApiResource
     attr_reader :name
+
     ##
     #
     # Initialize a MetadataTable with a table name

data/lib/iterable/push.rb

@@ -0,0 +1,46 @@
+module Iterable
+  ##
+  #
+  # Interact with /push API endpoints
+  #
+  # @example Creating push endpoint object
+  #   # With default config
+  #   templates = Iterable::Push.new
+  #   templates.target campaign_id: '12345'
+  #
+  class Push < ApiResource
+    ##
+    #
+    # Send a push notification to a specific user
+    #
+    # @param email [String] (optional) User email used to identify user
+    # @param campaign_id [Integer] Campaign ID
+    # @param attrs [Hash] Additional data to update or add
+    #
+    # @return [Iterable::Response] A response object
+    def target(campaign_id:, email: nil, attrs: {})
+      attrs['recipientEmail'] = email if email
+      attrs['campaignId'] = campaign_id
+      Iterable.request(conf, '/push/target').post(attrs)
+    end
+
+    ##
+    #
+    # Cancel a push notification to a specific user
+    # Must include either an email address AND campaignId, or
+    # just a scheduledMessageId provided in the attrs
+    #
+    # @param email [String] User email to cancel push
+    # @param campaignId [Integer] campaignID used to cancel push
+    # @param attrs [Hash] Additional data to update or add
+    #
+    # @return [Iterable::Response] A response object
+    #
+    # @note An email or UserId is required
+    def cancel(email: nil, campaign_id: nil, attrs: {})
+      attrs['email'] = email if email
+      attrs['campaignId'] = campaign_id if campaign_id
+      Iterable.request(conf, '/push/cancel').post(attrs)
+    end
+  end
+end

data/lib/iterable/request.rb

@@ -49,7 +49,8 @@ module Iterable
     end
 
     private def connection(verb, body = {}, headers = {})
-      conn_headers = DEFAULT_HEADERS.merge(headers)
+      conn_headers = DEFAULT_HEADERS.dup.merge(headers)
+      conn_headers['Api-Key'] = @config.token if @config.token
       req = Net::HTTP.const_get(verb.to_s.capitalize, false).new(@uri, conn_headers)
       req.body = JSON.dump(body)
       req
@@ -65,8 +66,7 @@ module Iterable
     private def build_uri(path, params = {})
       uri = @config.uri
       uri.path += path
-      params['api_key'] = @config.token
-      uri.query = URI.encode_www_form(params)
+      uri.query = URI.encode_www_form(params) unless params.empty?
       uri
     end
 

data/lib/iterable.rb

@@ -22,6 +22,7 @@ files = %w[
   templates
   email_templates
   push_templates
+  push
   users
   workflows
   metadata
@@ -52,10 +53,8 @@ module Iterable
   #   Iterable.configure do |conf|
   #     conf.token = 'secret-token'
   #   end
-  module_function def configure
-    config.tap do |conf|
-      yield conf
-    end
+  module_function def configure(&block)
+    config.tap(&block)
   end
 
   ##

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: iterable-api-client
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.5.0
 platform: ruby
 authors:
 - Chavez
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain:
 - |
@@ -35,7 +35,7 @@ cert_chain:
   skirV2p91csPqqACuQCX2oK9r29QZtt95aAnVdsdBMA+evI2nVknO0OhYDqNA0wR
   SkUCdTSDgV9CsbN/vy6DeR0eX1kP6OrntZJjKnrncbkKZnrJ5fjzKtUyj3I=
   -----END CERTIFICATE-----
-date: 2022-05-16 00:00:00.000000000 Z
+date: 2023-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -52,173 +52,187 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.12.0
 - !ruby/object:Gem::Dependency
-  name: coveralls
+  name: dotenv
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.21
+        version: 2.7.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.21
+        version: 2.7.1
 - !ruby/object:Gem::Dependency
-  name: dotenv
+  name: gemcutter
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.2.0
+        version: 0.7.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.2.0
+        version: 0.7.1
 - !ruby/object:Gem::Dependency
-  name: gemcutter
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.7.1
+        version: 0.14.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.7.1
+        version: 0.14.1
 - !ruby/object:Gem::Dependency
-  name: multi_json
+  name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.12.1
+        version: 3.8.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.12.1
+        version: 3.8.0
 - !ruby/object:Gem::Dependency
-  name: pry
+  name: pry-doc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.4
+        version: 1.3.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.4
+        version: 1.3.0
 - !ruby/object:Gem::Dependency
-  name: pry-byebug
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.4.2
+        version: 13.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.4.2
+        version: 13.0.0
 - !ruby/object:Gem::Dependency
-  name: pry-doc
+  name: redcarpet
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.11.1
+        version: 3.5.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.11.1
+        version: 3.5.0
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 12.0.0
+        version: 3.11.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 12.0.0
+        version: 3.11.0
 - !ruby/object:Gem::Dependency
-  name: redcarpet
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.4.0
+        version: 1.29.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.4.0
+        version: 1.29.1
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.6.0
+        version: 1.13.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.6.0
+        version: 1.13.3
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.89.1
+        version: 2.11.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.89.1
+        version: 2.11.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.14.1
+        version: 0.21.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.14.1
+        version: 0.21.2
+- !ruby/object:Gem::Dependency
+  name: simplecov-cobertura
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
 - !ruby/object:Gem::Dependency
   name: typhoeus
   requirement: !ruby/object:Gem::Requirement
@@ -253,28 +267,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.8.3
+        version: 3.14.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.8.3
+        version: 3.14.0
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.5
+        version: 0.9.11
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.5
+        version: 0.9.11
 description: Ruby gem for the Iterable REST API
 email: contact@el-chavez.me
 executables: []
@@ -308,6 +322,7 @@ files:
 - lib/iterable/message_types.rb
 - lib/iterable/metadata.rb
 - lib/iterable/metadata_table.rb
+- lib/iterable/push.rb
 - lib/iterable/push_templates.rb
 - lib/iterable/request.rb
 - lib/iterable/response.rb
@@ -315,11 +330,12 @@ files:
 - lib/iterable/users.rb
 - lib/iterable/workflows.rb
 - lib/iterable_api_client.rb
-homepage: http://gitlab.com/mtchavez/iterable
+homepage: https://gitlab.com/mtchavez/iterable
 licenses:
 - MIT
-metadata: {}
-post_install_message:
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message: 
 rdoc_options:
 - "--charset=UTF-8"
 - "--main=README.md"
@@ -329,15 +345,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key:
+rubygems_version: 3.1.6
+signing_key: 
 specification_version: 4
 summary: Iterable REST API Client
 test_files: []