onsignal 5.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0dd60aab5dd2f9f314707ff831ef5daa5b5a001eddb01373ea45146354469150
+  data.tar.gz: c7e6bf9704c846825fdedb473aa21d692c7a3a33dd375055dc634a47723ee51b
+SHA512:
+  metadata.gz: cba30256ba8470dcec04dc3fce6332e9191bf1d425d0e4d1cca3c74cdbb3017a0d4a409cff89259709da2fb202869ef24695866cc3ed1c5217492604f3a113f5
+  data.tar.gz: 514059dc5200cee8adba10b81bdf7af50a666cbf33c25daeb69cf03a5be53f63fa442baf0f1899d4ecac519f216ab5c7943fb8d9c350cf17bd37f8fdd5d21c9b

data/CHANGELOG.md

@@ -0,0 +1,112 @@
+# Changelog
+
+### master
+
+* nothing yet
+
+### 5.0.0 - 2018/02/09
+
+* features
+    * new ES6 JavaScript API
+    * streamlined `Device` model (Rails API)
+
+### 4.0.1 - 2018/02/08
+
+* bugfixes
+    * fixed not exporting `init()` function
+
+### 4.0.0 - 2018/02/08
+
+* features
+    * add ES6/Webpack support
+
+### 3.2.0 - 2018/01/21
+
+* features
+    * add `OneSignalSubscribed()` function
+
+### 3.1.5 - 2018/01/06
+
+* enhancements
+    * cleaning up gem files
+
+### 3.1.4 - 2018/01/02
+
+* bugfixes
+    * fixed overriding `set_device_owner` method
+
+### 3.1.3 - 2018/01/02
+
+* bugfixes
+    * fixed overriding `set_device_owner` method
+
+### 3.1.2 - 2017/12/28
+
+* bugfixes
+    * fix `has_devices` method
+
+### 3.1.1 - 2017/12/28
+
+* bugfixes
+    * fix `has_devices` method
+
+### 3.1.0 - 2017/12/27
+
+* features
+    * add `has_devices` method
+
+### 3.0.2 - 2017/12/21
+
+* bugfixes
+    * fixed `undefined method 'set_device_owner' for ApplicationController:Class`
+
+### 3.0.1 - 2017/12/21
+
+* bugfixes
+    * custom `set_device_owner` method was not overriding default
+
+### 3.0.0 - 2017/12/21
+
+* features
+    * made Devise optional
+    * added `owner` association to `Device` model
+* enhancements
+    * renamed elements of the javascript API
+
+### 2.0.1 - 2017/12/20
+
+* bugfixes
+    * fixed `undefined method 'permission=' for #<Device>`
+
+### 2.0.0 - 2017/12/19
+
+* features
+    * automatically include helpers and concerns
+    * configuration by passing a block to `configure`
+    * introducing `Device` activerecord model
+* enhancements
+    * rename `current_onesignal` method to `current_device`
+
+### 1.2.1 - 2017/12/18
+
+* enhancements
+    * add more configuration options
+
+### 1.1.1 - 2017/12/18
+
+* bugfixes
+    * fixed use of wrong class name
+
+### 1.1.0 - 2017/12/18
+
+* enhancements
+    * dont't include keys in `current_onesignal` hash whose values are `nil`
+
+### 1.0.1 - 2017/12/18
+
+* bugfixes
+    * fixed `Stack Level too deep` when using `current_onesignal`
+
+### 1.0.0 - 2017/12/18
+
+* initial release

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Jonas Hübotter
+
+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 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

@@ -0,0 +1,254 @@
+# OnSignal
+
+![NPM Version](https://img.shields.io/npm/v/onsignal.svg) [![Gem Version](https://badge.fury.io/rb/onsignal.svg)](https://badge.fury.io/rb/onsignal) <img src="https://travis-ci.org/jonhue/onsignal.svg?branch=master" />
+
+A OneSignal API wrapper simplifying user targeted cross platform notifications. OnSignal consists of a JavaScript and a Rails API:
+
+* [JavaScript API](#javascript-api): Handle user subscriptions to OneSignal in your frontend code.
+* [Rails API](#javascript-api): Attach OneSignal players to user records provided by an authentication solution.
+
+---
+
+## Table of Contents
+
+* [JavaScript API](#javascript-api)
+    * [Overview](#overview)
+    * [Subscribing](#subscribing)
+    * [Unsubscribing](#unsubscribing)
+    * [Additional functions](#additional-functions)
+* [Rails API](#javascript-api)
+    * [Installation](#installation)
+    * [User associations](#user-associations)
+    * [Devices](#devices)
+        * [Methods](#methods)
+        * [Helpers](#helpers)
+    * [Configuration](#configuration)
+* [To Do](#to-do)
+* [Contributing](#contributing)
+    * [Contributors](#contributors)
+    * [Semantic versioning](#semantic-versioning)
+* [License](#license)
+
+---
+
+## JavaScript API
+
+Handle user subscriptions to OneSignal in your frontend code.
+
+### Overview
+
+```javascript
+import OnSignal from 'onsignal';
+let onSignal = new OnSignal( 'OneSignal App ID', {
+    autoRegister: false
+});
+
+// Object to call OneSignal API from
+onSignal.oneSignal;
+
+// Current users player ID
+onSignal.playerId;
+
+// Current users permission
+onSignal.permission;
+```
+
+#### Options
+
+Pass options to OneSignal's `push(['init', {...}])` function as a hash. Default values are:
+
+* `autoRegister` Automatically try to subscribe the user when loading a page. Accepts a boolean. Defaults to `false`.
+* `persistNotification` Automatically dismiss notifications after ~20 seconds in Chrome Desktop v47+. Accepts a boolean. Defaults to `false`.
+* `welcomeNotification` Hash configuring the default OneSignal welcome notification. Accepts a hash. Defaults to `{ disable: true }`.
+* `notifyButton` Hash configuring the default OneSignal notify button at the bottom right of the screen. Accepts a hash. Defaults to `{ enable: false }`.
+
+### Subscribing
+
+Just call `onSignal.subscribe();` and OneSignal will ask your user for permission to send notifications if he is not subscribed yet. _On the following request an existing `Device` object will either get updated or a new one will get created. (if using the Rails API)_
+
+#### Options
+
+Pass options to OneSignal's `registerForPushNotifications()` function as a hash. Default values are:
+
+* `modalPrompt` Whether or not to use a custom prompt instead of the browsers default to ask for permission. Accepts a boolean. Defaults to `false`.
+
+### Unsubscribing
+
+**Note:** You most likely don't want to let your users unsubscribe from receiving notifications, but instead allow them to manually disable receiving any new notifications. For that purpose use the [notifications-rails](https://github.com/jonhue/notifications-rails) gem, which adds a notification API and detailed user settings.
+
+If you want to completely remove a user from OneSignal, call `onSignal.unsubscribe();`.
+
+### Additional functions
+
+```javascript
+// Check if a user is subscribed to OneSignal
+onSignal.isSubscribed()
+```
+
+---
+
+## Rails API
+
+Attach OneSignal players to user records provided by an authentication solution.
+
+### Installation
+
+OnSignal works with Rails 5 onwards. You can add it to your `Gemfile` with:
+
+```ruby
+gem 'onsignal'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install onsignal
+
+If you always want to be up to date fetch the latest from GitHub in your `Gemfile`:
+
+```ruby
+gem 'onsignal', github: 'jonhue/onsignal'
+```
+
+Now run the generator:
+
+    $ rails g onsignal
+
+To wrap things up, migrate the changes into your database:
+
+    $ rails db:migrate
+
+### User associations
+
+Define an association in models whose objects are supposed to be associated with OneSignal players. For example `Admin` in `app/models/admin.rb`.
+
+```ruby
+class Admin < ApplicationRecord
+    onsignal
+end
+```
+
+Next attach a user object by defining a `set_onsignal_user` method. Let's say model is named `Admin` and `current_admin` is available at controller level. Just add a method to your `ApplicationController`:
+
+```ruby
+def set_onsignal_user
+    current_admin if current_admin
+end
+```
+
+**Note:** If a `current_user` method is available at controller level this method is not required.
+
+You are now able to get OneSignal players for a specific user:
+
+```ruby
+a = Admin.first
+
+# All device records of a user
+a.devices
+
+# All OneSignal Player ID's of a user returned as an array
+a.onesignal_player_ids
+```
+
+### Devices
+
+OnSignal introduces a `Device` ActiveRecord model. You can [configure](#configuration) its name. Every record of an associated user class can have multiple devices - one for each device / browser they enabled OneSignal on.
+
+#### Methods
+
+```ruby
+d = Device.first
+
+# Returns user associated with device. Can return `nil`.
+d.owner
+
+# Returns OneSignal player id
+d.onesignal_id
+
+# Returns OneSignal permission ( `granted` / `denied` / `default` )
+d.onesignal_permission
+
+# Some timestamps
+d.last_used
+d.created_at
+d.updated_at
+
+
+# If device is ready to receive notifications
+d.onesignal_enabled?
+
+# If device has been disabled to receive notifications
+d.onesignal_disabled?
+
+# If device has been set previously to receive notifications or not
+d.onesignal_set?
+```
+
+#### Helpers
+
+In your controllers and views you can access a `current_onsignal` method that returns the `Device` object of the current OneSignal subscription. If the user browsing your site is not subscribed to OneSignal, `current_onsignal` returns an uncommitted `Device` object with some helpful information, like the `permission` attribute, set.
+
+### Configuration
+
+You can configure OnSignal by passing a block to `configure`. This can be done in `config/initializers/onsignal.rb`:
+
+```ruby
+OnSignal.configure do |config|
+    config.device_const = 'Device'
+end
+```
+
+* `device_const` Name of the constant exposing devices. Takes a constant name (string). Defaults to `'Device'`.
+
+---
+
+## To Do
+
+[Here](https://github.com/jonhue/devise-onesignal/projects/1) is the full list of current projects.
+
+To propose your ideas, initiate the discussion by adding a [new issue](https://github.com/jonhue/devise-onesignal/issues/new).
+
+---
+
+## Contributing
+
+We hope that you will consider contributing to devise-onesignal. Please read this short overview for some information about how to get started:
+
+[Learn more about contributing to this repository](https://github.com/jonhue/devise-onesignal/blob/master/CONTRIBUTING.md), [Code of Conduct](https://github.com/jonhue/devise-onesignal/blob/master/CODE_OF_CONDUCT.md)
+
+### Contributors
+
+Give the people some :heart: who are working on this project. See them all at:
+
+https://github.com/jonhue/devise-onesignal/graphs/contributors
+
+### Semantic Versioning
+
+devise-onesignal follows Semantic Versioning 2.0 as defined at http://semver.org.
+
+## License
+
+MIT License
+
+Copyright (c) 2017 Jonas Hübotter
+
+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 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/app/controllers/concerns/on_signal_controller.rb

@@ -0,0 +1,26 @@
+module OnSignalController
+
+    extend ActiveSupport::Concern
+
+    included do
+        before_action :set_onsignal
+    end
+
+    def set_onsignal_user
+        current_user if current_user
+    end
+
+    private
+
+    def set_onsignal
+        unless cookies[:oneSignalPlayerId].nil?
+            onesignal_player_id = cookies[:oneSignalPlayerId]
+            device = OnSignal.configuration.device_const.constantize.find_or_create_by! onesignal_id: onesignal_player_id
+            device.onesignal_permission = cookies[:oneSignalPlayerPermission]
+            device.last_used = Time.now
+            device.owner = set_onesignal_user
+            device.save!
+        end
+    end
+
+end

data/app/helpers/on_signal_helper.rb

@@ -0,0 +1,15 @@
+module OnSignalHelper
+
+    def current_onsignal
+        if cookies[:oneSignalPlayerId].nil?
+            device = OnSignal.configuration.device_const.constantize.new
+            device.onesignal_permission = cookies[:oneSignalPlayerPermission]
+            device.owner = set_onsignal_owner
+            device.last_used = Time.now
+        else
+            device = OnSignal.configuration.device_const.constantize.find_by onesignal_id: cookies[:oneSignalPlayerId]
+        end
+        device
+    end
+
+end

data/app/models/concerns/on_signal_model.rb

@@ -0,0 +1,24 @@
+module OnSignalModel
+
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+        def onsignal
+            has_many :devices, as: :owner, class_name: OnSignal.configuration.device_const, dependent: :destroy
+            include OnSignal::Owner::InstanceMethods
+        end
+    end
+
+    module InstanceMethods
+
+        def onesignal_player_ids
+            onesignal_player_ids = []
+            self.devices.each do |device|
+                onesignal_player_ids << device.onesignal_id
+            end
+            onesignal_player_ids
+        end
+
+    end
+
+end

data/app/models/on_signal/device.rb

@@ -0,0 +1,15 @@
+class OnSignal::Device < ApplicationRecord
+
+    def onesignal_enabled?
+        self.onesignal_permission == 'granted'
+    end
+    def onesignal_disabled?
+        self.onesignal_permission == 'denied'
+    end
+    def onesignal_set?
+        !self.onesignal_permission == 'default'
+    end
+
+    belongs_to :owner, polymorphic: true, optional: true
+
+end

data/lib/generators/onsignal_generator.rb

@@ -0,0 +1,42 @@
+require 'rails/generators'
+require 'rails/generators/migration'
+
+class OnsignalGenerator < Rails::Generators::Base
+
+    include Rails::Generators::Migration
+
+    source_root File.join File.dirname(__FILE__), 'templates'
+    desc 'Install OnSignal'
+
+    def self.next_migration_number dirname
+        if ActiveRecord::Base.timestamped_migrations
+            Time.now.utc.strftime '%Y%m%d%H%M%S'
+        else
+            "%.3d" % ( current_migration_number(dirname) + 1 )
+        end
+    end
+
+    def create_initializer
+        template 'initializer.rb', 'config/initializers/onsignal.rb'
+    end
+
+    def create_device_migration_file
+        migration_template 'devices_migration.rb.erb', 'db/migrate/onsignal_migration.rb', migration_version: migration_version
+    end
+    def create_device_model
+        template 'device_model.rb', 'app/models/device.rb'
+    end
+
+    def show_readme
+        readme 'README.md'
+    end
+
+    private
+
+    def migration_version
+        if Rails.version >= '5.0.0'
+            "[#{Rails::VERSION::MAJOR}.#{Rails::VERSION::MINOR}]"
+        end
+    end
+
+end

data/lib/generators/templates/README.md

@@ -0,0 +1 @@
+Now run `rails db:migrate` to add onsignal to your database.

data/lib/generators/templates/device_model.rb

@@ -0,0 +1,2 @@
+class Device < OnSignal::Device
+end

data/lib/generators/templates/devices_migration.rb.erb

@@ -0,0 +1,16 @@
+class OnsignalMigration < ActiveRecord::Migration<%= migration_version %>
+    def change
+        create_table :devices do |t|
+
+            t.references :owner, polymorphic: true, index: true
+
+            t.string :onesignal_id, index: true, unique: true
+            t.string :onesignal_permission
+
+            t.datetime :last_used
+
+            t.timestamps
+
+        end
+    end
+end

data/lib/generators/templates/initializer.rb

@@ -0,0 +1,6 @@
+OnSignal.configure do |config|
+
+    # Name of the constant exposing devices
+    config.device_const = 'Device'
+
+end

data/lib/on_signal/configuration.rb

@@ -0,0 +1,21 @@
+module OnSignal
+
+    class << self
+        attr_accessor :configuration
+    end
+
+    def self.configure
+        self.configuration ||= Configuration.new
+        yield configuration
+    end
+
+    class Configuration
+
+        attr_accessor :device_const
+
+        def initialize
+            @device_const = 'Device'
+        end
+
+    end
+end

data/lib/on_signal/engine.rb

@@ -0,0 +1,6 @@
+require 'rails/railtie'
+
+module OnSignal
+    class Engine < ::Rails::Engine
+    end
+end

data/lib/on_signal/railtie.rb

@@ -0,0 +1,17 @@
+require 'rails/railtie'
+
+module OnSignal
+    class Railtie < Rails::Railtie
+
+        initializer 'onsignal.initialize' do
+            ActiveSupport.on_load :action_controller do
+                include OnSignalHelper
+                include OnSignalController
+            end
+            ActiveSupport.on_load :active_record do
+                include OnSignalModel
+            end
+        end
+
+    end
+end

data/lib/on_signal/version.rb

@@ -0,0 +1,5 @@
+module OnSignal
+
+    VERSION = '5.0.0'
+
+end

data/lib/onsignal.rb

@@ -0,0 +1,10 @@
+require 'on_signal/version'
+
+module OnSignal
+
+    require 'on_signal/configuration'
+
+    require 'on_signal/engine'
+    require 'on_signal/railtie'
+
+end

metadata

@@ -0,0 +1,179 @@
+--- !ruby/object:Gem::Specification
+name: onsignal
+version: !ruby/object:Gem::Version
+  version: 5.0.0
+platform: ruby
+authors:
+- Jonas Hübotter
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-02-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: actionview
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.52'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.52'
+description: OneSignal API wrapper simplifying user targeted cross platform notifications.
+email: me@jonhue.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- app/controllers/concerns/on_signal_controller.rb
+- app/helpers/on_signal_helper.rb
+- app/models/concerns/on_signal_model.rb
+- app/models/on_signal/device.rb
+- lib/generators/onsignal_generator.rb
+- lib/generators/templates/README.md
+- lib/generators/templates/device_model.rb
+- lib/generators/templates/devices_migration.rb.erb
+- lib/generators/templates/initializer.rb
+- lib/on_signal/configuration.rb
+- lib/on_signal/engine.rb
+- lib/on_signal/railtie.rb
+- lib/on_signal/version.rb
+- lib/onsignal.rb
+homepage: https://github.com/jonhue/onsignal
+licenses:
+- MIT
+metadata: {}
+post_install_message: |
+  **Thank you for installing OnSignal!**
+
+
+  There are four wo more steps to take:
+
+  1) Run `rails g devise_onesignal` and `rails db:migrate`
+  2) Enter your OneSignal App ID in config/initializers/devise-onesignal.rb
+  3) Add:
+
+      import 'devise-onesignal/dist/OneSignalSDK';
+      import * as deviseOneSignal from 'devise-onesignal';
+
+  to your webpack pack in app/javascript/packs/application.js
+  4) Add:
+
+      has_devices
+
+  to your authentication model
+
+
+  Learn more at https://github.com/jonhue/devise-onesignal
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.4
+signing_key: 
+specification_version: 4
+summary: OneSignal API wrapper simplifying user targeted cross platform notifications
+test_files: []