Module: WebPush

Defined in:
lib/web_push.rb,
lib/web_push/errors.rb,
lib/web_push/request.rb,
lib/web_push/version.rb,
lib/web_push/vapid_key.rb,
lib/web_push/encryption.rb

Overview

Push API implementation

tools.ietf.org/html/rfc8030 www.w3.org/TR/push-api/

Defined Under Namespace

Modules: Encryption Classes: ConfigurationError, Error, ExpiredSubscription, InvalidSubscription, PayloadTooLarge, PushServiceError, Request, ResponseError, TooManyRequests, Unauthorized, VapidKey

Constant Summary collapse

VERSION = 
'3.0.2'.freeze

Class Method Summary collapse

Class Method Details

.decode64(str) ⇒ Object 



58
59
60
 
# File 'lib/web_push.rb', line 58

def decode64(str)
  Base64.urlsafe_decode64(str)
end

.encode64(bytes) ⇒ Object 



54
55
56
 
# File 'lib/web_push.rb', line 54

def encode64(bytes)
  Base64.urlsafe_encode64(bytes)
end

.generate_key ⇒ WebPush::VapidKey

Generate a VapidKey instance to obtain base64 encoded public and private keys suitable for VAPID protocol JSON web token signing

Returns:



50
51
52
 
# File 'lib/web_push.rb', line 50

def generate_key
  VapidKey.new
end

.payload_send(message: '', endpoint:, p256dh: '', auth: '', vapid: {}, **options) ⇒ Object

Deliver the payload to the required endpoint given by the JavaScript PushSubscription. Including an optional message requires p256dh and auth keys from the PushSubscription.

Parameters:

  • endpoint (String) —

    the required PushSubscription url

  • message (String) (defaults to: '') —

    the optional payload

  • p256dh (String) (defaults to: '') —

    the user’s public ECDH key given by the PushSubscription

  • auth (String) (defaults to: '') —

    the user’s private ECDH key given by the PushSubscription

  • vapid (Hash<Symbol,String>) (defaults to: {}) —

    options for VAPID

  • options (Hash<Symbol,String>) —

    additional options for the notification

Options Hash (vapid:):

  • :subject (String) —

    contact URI for the app server as a “mailto:” or an “https:”

  • :public_key (String) —

    the VAPID public key

  • :private_key (String) —

    the VAPID private key

Options Hash (**options):

  • :ttl (#to_s) —

    Time-to-live in seconds

  • :urgency (#to_s) —

    Urgency can be very-low, low, normal, high



37
38
39
40
41
42
43
44
 
# File 'lib/web_push.rb', line 37

def payload_send(message: '', endpoint:, p256dh: '', auth: '', vapid: {}, **options)
  WebPush::Request.new(
    message: message,
    subscription: subscription(endpoint, p256dh, auth),
    vapid: vapid,
    **options
  ).perform
end