pushpad 1.2.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ca523c6dd48111c5a369889092c80690401158c3f0a14142eb3aee236848062
-  data.tar.gz: 637c8461863686d6c3c1f9f666a7df74b2053aed5017318f360054f908b83fbe
+  metadata.gz: 5a4c81351920b86c10b9926e94eb2aca07a9da9b87ddb3f9d4725459a0993e9c
+  data.tar.gz: 657f63d05bcabe69c8a197199ab516452d893450ad221b33a07b28162eb7d9be
 SHA512:
-  metadata.gz: 7aaed7d9218f698803bf1adda9ba1459365b49eaba897903b1cab109aeb9bb825ab40b25119a52cc620d515dd7cce36ad8509d34baacb7b74d58028c26327207
-  data.tar.gz: 0e89ea2619f3c6f39c4a073c95d56faa451e672b86ad3d898e681b53c7ecef59af7e2b7b5fd22b3be957ab02cb7fcc98b6c7e4a84b5a328e853f6c5abc8905ac
+  metadata.gz: 6a1e76b5ebfc31b43af6ff17d394c3f4bc88b41f359ab42359e018e5a213bda46c93ca830b3ec663b6b04d915244eda457463305ded412eb56fc448b50cac332
+  data.tar.gz: cebbc1b3610953a2064549998acc12348e9bd33c69ef97d20bbfb5f6bdcc4d7c94357cc0296dd4584ec68cb4ac8b3cb883cfa0cd774bff842dc326c1c760abd6

data/README.md

@@ -260,6 +260,96 @@ to get the full list in multiple requests.
 subscriptions = Pushpad::Subscription.find_all(project_id: 5, page: 2)
 ```
 
+You can also retrieve the data of a specific subscription if you already know its id:
+
+```ruby
+Pushpad::Subscription.find 123
+Pushpad::Subscription.find 123, project_id: 456
+```
+
+## Updating push subscription data
+
+Usually you add data, like user IDs and tags, to the push subscriptions using the [JavaScript SDK](https://pushpad.xyz/docs/javascript_sdk_reference) in the frontend.
+
+However you can also update the subscription data from your server:
+
+```ruby
+Pushpad::Subscription.find_all(uids: ['user1']).each do |subscription|
+  # update the user ID associated to the push subscription
+  subscription.update uid: 'myuser1'
+  
+  # update the tags associated to the push subscription
+  tags = subscription.tags
+  tags << 'another_tag'
+  subscription.update tags: tags
+end
+```
+
+## Importing push subscriptions
+
+If you need to [import](https://pushpad.xyz/docs/import) some existing push subscriptions (from another service to Pushpad, or from your backups) or if you simply need to create some test data, you can use this method:
+
+```ruby
+attributes = {
+  endpoint: "https://example.com/push/f7Q1Eyf7EyfAb1", 
+  p256dh: "BCQVDTlYWdl05lal3lG5SKr3VxTrEWpZErbkxWrzknHrIKFwihDoZpc_2sH6Sh08h-CacUYI-H8gW4jH-uMYZQ4=",
+  auth: "cdKMlhgVeSPzCXZ3V7FtgQ==",
+  uid: "exampleUid", 
+  tags: ["exampleTag1", "exampleTag2"]
+}
+
+subscription = Pushpad::Subscription.create(attributes, project_id: 5)
+```
+
+Please note that this is not the standard way to collect subscriptions on Pushpad: usually you subscribe the users to the notifications using the [JavaScript SDK](https://pushpad.xyz/docs/javascript_sdk_reference) in the frontend.
+
+## Deleting push subscriptions
+
+Usually you unsubscribe a user from push notifications using the [JavaScript SDK](https://pushpad.xyz/docs/javascript_sdk_reference) in the frontend (recommended).
+
+However you can also delete the subscriptions using this library. Be careful, the subscriptions are permanently deleted!
+
+```ruby
+subscription = Pushpad::Subscription.find 123
+subscription.delete
+```
+
+## Managing projects
+
+Projects are usually created manually from the Pushpad dashboard. However you can also create projects from code if you need advanced automation or if you manage [many different domains](https://pushpad.xyz/docs/multiple_domains).
+
+```ruby
+attributes = {
+  # required attributes
+  sender_id: 123,
+  name: "My project",
+  website: "https://example.com",
+  
+  # optional configurations
+  icon_url: "https://example.com/icon.png",
+  badge_url: "https://example.com/badge.png",
+  notifications_ttl: 604800,
+  notifications_require_interaction: false,
+  notifications_silent: false
+}
+
+project = Pushpad::Project.create(attributes)
+```
+
+You can also find, update and delete projects:
+
+```ruby
+Pushpad::Project.find_all.each do |p|
+  puts "Project #{p.id}: #{p.name}"
+end
+
+project = Pushpad::Project.find 123
+
+project.update(name: 'The New Project Name')
+
+project.delete
+```
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/lib/pushpad/project.rb

@@ -0,0 +1,95 @@
+module Pushpad
+  class Project
+    class CreateError < RuntimeError
+    end
+    
+    class FindError < RuntimeError
+    end
+    
+    class UpdateError < RuntimeError
+    end
+    
+    class DeleteError < RuntimeError
+    end
+    
+    ATTRIBUTES = :id, :sender_id, :name, :website, :icon_url, :badge_url, :notifications_ttl, :notifications_require_interaction, :notifications_silent, :created_at
+    
+    attr_reader *ATTRIBUTES
+    
+    def initialize(options)
+      @id = options[:id]
+      @sender_id = options[:sender_id]
+      @name = options[:name]
+      @website = options[:website]
+      @icon_url = options[:icon_url]
+      @badge_url = options[:badge_url]
+      @notifications_ttl = options[:notifications_ttl]
+      @notifications_require_interaction = options[:notifications_require_interaction] 
+      @notifications_silent = options[:notifications_silent]
+      @created_at = options[:created_at] && Time.parse(options[:created_at])
+    end
+    
+    def self.create(attributes)      
+      endpoint = "https://pushpad.xyz/api/v1/projects"
+      response = Request.post(endpoint, attributes.to_json)
+      
+      unless response.code == "201"
+        raise CreateError, "Response #{response.code} #{response.message}: #{response.body}"
+      end
+      
+      new(JSON.parse(response.body, symbolize_names: true))
+    end
+    
+    def self.find(id)  
+      response = Request.get("https://pushpad.xyz/api/v1/projects/#{id}")
+      
+      unless response.code == "200"
+        raise FindError, "Response #{response.code} #{response.message}: #{response.body}"
+      end
+      
+      new(JSON.parse(response.body, symbolize_names: true))
+    end
+    
+    def self.find_all
+      response = Request.get("https://pushpad.xyz/api/v1/projects")
+      
+      unless response.code == "200"
+        raise FindError, "Response #{response.code} #{response.message}: #{response.body}"
+      end
+      
+      JSON.parse(response.body, symbolize_names: true).map do |attributes|
+        new(attributes)
+      end
+    end
+    
+    def update(attributes)      
+      raise "You must set id" unless id
+      
+      endpoint = "https://pushpad.xyz/api/v1/projects/#{id}"
+      response = Request.patch(endpoint, attributes.to_json)
+      
+      unless response.code == "200"
+        raise UpdateError, "Response #{response.code} #{response.message}: #{response.body}"
+      end
+      
+      updated = self.class.new(JSON.parse(response.body, symbolize_names: true))
+      
+      ATTRIBUTES.each do |attr|
+        self.instance_variable_set("@#{attr}", updated.instance_variable_get("@#{attr}"))
+      end
+      
+      self
+    end
+    
+    def delete      
+      raise "You must set id" unless id
+      
+      response = Request.delete("https://pushpad.xyz/api/v1/projects/#{id}")
+      
+      unless response.code == "202"
+        raise DeleteError, "Response #{response.code} #{response.message}: #{response.body}"
+      end
+    end
+    
+  end
+end

data/lib/pushpad/request.rb

@@ -19,6 +19,12 @@ module Pushpad
       end
     end
     
+    def patch(endpoint, body, options = {})
+      perform(Net::HTTP::Patch, endpoint, options) do |request|
+        request.body = body
+      end
+    end
+    
     def delete(endpoint, options = {})
       perform(Net::HTTP::Delete, endpoint, options)
     end

data/lib/pushpad/subscription.rb

@@ -1,11 +1,20 @@
 module Pushpad
   class Subscription
+    class CreateError < RuntimeError
+    end
+    
+    class UpdateError < RuntimeError
+    end
+    
     class CountError < RuntimeError
     end
     
     class FindError < RuntimeError
     end
     
+    class DeleteError < RuntimeError
+    end
+    
     attr_reader :id, :endpoint, :p256dh, :auth, :uid, :tags, :last_click_at, :created_at
 
     def initialize(options)
@@ -18,6 +27,20 @@ module Pushpad
       @last_click_at = options[:last_click_at] && Time.parse(options[:last_click_at])
       @created_at = options[:created_at] && Time.parse(options[:created_at])
     end
+    
+    def self.create(attributes, options = {})
+      project_id = options[:project_id] || Pushpad.project_id
+      raise "You must set project_id" unless project_id
+      
+      endpoint = "https://pushpad.xyz/api/v1/projects/#{project_id}/subscriptions"
+      response = Request.post(endpoint, attributes.to_json)
+
+      unless response.code == "201"
+        raise CreateError, "Response #{response.code} #{response.message}: #{response.body}"
+      end
+      
+      new(JSON.parse(response.body, symbolize_names: true))
+    end
 
     def self.count(options = {})
       project_id = options[:project_id] || Pushpad.project_id
@@ -33,6 +56,19 @@ module Pushpad
       response["X-Total-Count"].to_i
     end
     
+    def self.find(id, options = {})
+      project_id = options[:project_id] || Pushpad.project_id
+      raise "You must set project_id" unless project_id
+      
+      response = Request.get("https://pushpad.xyz/api/v1/projects/#{project_id}/subscriptions/#{id}")
+
+      unless response.code == "200"
+        raise FindError, "Response #{response.code} #{response.message}: #{response.body}"
+      end
+
+      new(JSON.parse(response.body, symbolize_names: true))
+    end
+    
     def self.find_all(options = {})
       project_id = options[:project_id] || Pushpad.project_id
       raise "You must set project_id" unless project_id
@@ -51,6 +87,39 @@ module Pushpad
         new(attributes)
       end
     end
+    
+    def update(attributes, options = {})
+      project_id = options[:project_id] || Pushpad.project_id
+      raise "You must set project_id" unless project_id
+      
+      raise "You must set id" unless id
+      
+      endpoint = "https://pushpad.xyz/api/v1/projects/#{project_id}/subscriptions/#{id}"
+      response = Request.patch(endpoint, attributes.to_json)
+
+      unless response.code == "200"
+        raise UpdateError, "Response #{response.code} #{response.message}: #{response.body}"
+      end
+      
+      attributes = JSON.parse(response.body, symbolize_names: true)
+      @uid = attributes[:uid]
+      @tags = attributes[:tags]
+      
+      self
+    end
+    
+    def delete(options = {})
+      project_id = options[:project_id] || Pushpad.project_id
+      raise "You must set project_id" unless project_id
+      
+      raise "You must set id" unless id
+      
+      response = Request.delete("https://pushpad.xyz/api/v1/projects/#{project_id}/subscriptions/#{id}")
+
+      unless response.code == "204"
+        raise DeleteError, "Response #{response.code} #{response.message}: #{response.body}"
+      end
+    end
 
     private
 

data/lib/pushpad.rb

@@ -3,6 +3,7 @@ require 'openssl'
 require "pushpad/request"
 require "pushpad/notification"
 require "pushpad/subscription"
+require "pushpad/project"
 
 module Pushpad
   @@auth_token = nil

data/pushpad.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name          = "pushpad"
-  spec.version       = '1.2.0'
+  spec.version       = '1.4.0'
   spec.authors       = ["Pushpad"]
   spec.email         = ["support@pushpad.xyz"]
   spec.summary       = "Web push notifications for Chrome, Firefox, Opera, Edge and Safari using Pushpad."

data/spec/pushpad/project_spec.rb

@@ -0,0 +1,211 @@
+require "spec_helper"
+
+module Pushpad
+  describe Project do
+    
+    def stub_projects_post(attributes = {})
+      stub_request(:post, "https://pushpad.xyz/api/v1/projects").
+        with(body: hash_including(attributes)).
+        to_return(status: 201, body: attributes.to_json)
+    end
+    
+    def stub_failing_projects_post
+      stub_request(:post, "https://pushpad.xyz/api/v1/projects").
+        to_return(status: 422)
+    end
+    
+    def stub_project_get(attributes)
+      stub_request(:get, "https://pushpad.xyz/api/v1/projects/#{attributes[:id]}").
+        to_return(status: 200, body: attributes.to_json)
+    end
+    
+    def stub_failing_project_get(attributes)
+      stub_request(:get, "https://pushpad.xyz/api/v1/projects/#{attributes[:id]}").
+        to_return(status: 404)
+    end
+    
+    def stub_projects_get(list)
+      stub_request(:get, "https://pushpad.xyz/api/v1/projects").
+        to_return(status: 200, body: list.to_json)
+    end
+    
+    def stub_failing_projects_get
+      stub_request(:get, "https://pushpad.xyz/api/v1/projects").
+        to_return(status: 401)
+    end
+    
+    def stub_project_patch(id, attributes)
+      stub_request(:patch, "https://pushpad.xyz/api/v1/projects/#{id}").
+        with(body: hash_including(attributes)).
+        to_return(status: 200, body: attributes.to_json)
+    end
+    
+    def stub_failing_project_patch(id)
+      stub_request(:patch, "https://pushpad.xyz/api/v1/projects/#{id}").
+        to_return(status: 422)
+    end
+    
+    def stub_project_delete(id)
+      stub_request(:delete, "https://pushpad.xyz/api/v1/projects/#{id}").
+        to_return(status: 202)
+    end
+    
+    def stub_failing_project_delete(id)
+      stub_request(:delete, "https://pushpad.xyz/api/v1/projects/#{id}").
+        to_return(status: 403)
+    end
+    
+    describe ".create" do
+      it "creates a new project with the given attributes and returns it" do
+        attributes = {
+          sender_id: 123,
+          name: "My project",
+          website: "https://example.com"
+        }
+        stub = stub_projects_post(attributes)
+        
+        project = Project.create(attributes)
+        expect(project).to have_attributes(attributes)
+        
+        expect(stub).to have_been_requested
+      end
+      
+      it "fails with CreateError if response status code is not 201" do
+        attributes = { name: "My project" }
+        stub_failing_projects_post
+        
+        expect {
+          Project.create(attributes)
+        }.to raise_error(Project::CreateError)
+      end
+    end
+    
+    describe ".find" do
+      it "returns project with attributes from json response" do
+        attributes = {
+          id: 361,
+          sender_id: 123,
+          name: "Example Project",
+          website: "https://example.com",
+          icon_url: "https://example.com/icon.png",
+          badge_url: "https://example.com/badge.png",
+          notifications_ttl: 604800,
+          notifications_require_interaction: false,
+          notifications_silent: false,
+          created_at: "2016-07-06T10:58:39.143Z"
+        }
+        stub_project_get(attributes)
+        
+        project = Project.find(361)
+        
+        attributes.delete(:created_at)
+        expect(project).to have_attributes(attributes)
+        expect(project.created_at.utc.to_s).to eq(Time.utc(2016, 7, 6, 10, 58, 39.143).to_s)
+      end
+
+      it "fails with FindError if response status code is not 200" do
+        attributes = { id: 362 }
+        stub_failing_project_get(attributes)
+        
+        expect {
+          Project.find(362)
+        }.to raise_error(Project::FindError)
+      end
+    end
+    
+    describe ".find_all" do
+      it "returns projects with attributes from json response" do
+        attributes = {
+          id: 361,
+          sender_id: 123,
+          name: "Example Project",
+          website: "https://example.com",
+          icon_url: "https://example.com/icon.png",
+          badge_url: "https://example.com/badge.png",
+          notifications_ttl: 604800,
+          notifications_require_interaction: false,
+          notifications_silent: false,
+          created_at: "2016-07-06T10:58:39.143Z"
+        }
+        stub_projects_get([attributes])
+        
+        projects = Project.find_all
+        
+        attributes.delete(:created_at)
+        expect(projects[0]).to have_attributes(attributes)
+        expect(projects[0].created_at.utc.to_s).to eq(Time.utc(2016, 7, 6, 10, 58, 39.143).to_s)
+      end
+
+      it "fails with FindError if response status code is not 200" do
+        stub_failing_projects_get
+        
+        expect {
+          Project.find_all
+        }.to raise_error(Project::FindError)
+      end
+
+      it "works properly when there are no results" do
+        stub_projects_get([])
+        
+        projects = Project.find_all
+        
+        expect(projects).to eq([])
+      end
+    end
+    
+    describe "#update" do
+      it "updates a project with the given attributes and returns it" do
+        attributes = {
+          name: "The New Project Name"
+        }
+        stub = stub_project_patch(5, attributes)
+        
+        project = Project.new(id: 5)
+        project.update attributes
+        expect(project).to have_attributes(attributes)
+        
+        expect(stub).to have_been_requested
+      end
+      
+      it "fails with UpdateError if response status code is not 200" do
+        attributes = { name: "" }
+        stub_failing_project_patch(5)
+        
+        project = Project.new(id: 5)
+        
+        expect {
+          project.update attributes
+        }.to raise_error(Project::UpdateError)
+      end
+      
+      it "fails with helpful error message when id is missing" do
+        expect {
+          Project.new(id: nil).update({})
+        }.to raise_error(/must set id/)
+      end
+    end
+    
+    describe "#delete" do
+      it "deletes a project" do
+        stub = stub_project_delete(5)
+        
+        project = Project.new(id: 5)
+        res = project.delete
+        expect(res).to be_nil
+        
+        expect(stub).to have_been_requested
+      end
+      
+      it "fails with DeleteError if response status code is not 202" do
+        stub_failing_project_delete(5)
+        
+        project = Project.new(id: 5)
+        
+        expect {
+          project.delete
+        }.to raise_error(Project::DeleteError)
+      end
+    end
+    
+  end
+end

data/spec/pushpad/subscription_spec.rb

@@ -2,6 +2,16 @@ require "spec_helper"
 
 module Pushpad
   describe Subscription do
+    def stub_subscription_get(options)
+      stub_request(:get, "https://pushpad.xyz/api/v1/projects/#{options[:project_id]}/subscriptions/#{options[:id]}").
+        to_return(status: 200, body: options[:attributes].to_json)
+    end
+
+    def stub_failing_subscription_get(options)
+      stub_request(:get, "https://pushpad.xyz/api/v1/projects/#{options[:project_id]}/subscriptions/#{options[:id]}").
+        to_return(status: 404)
+    end
+    
     def stub_subscriptions_head(options)
       stub_request(:head, "https://pushpad.xyz/api/v1/projects/#{options[:project_id]}/subscriptions").
         with(query: hash_including(options.fetch(:query, {}))).
@@ -24,6 +34,63 @@ module Pushpad
       stub_request(:get, "https://pushpad.xyz/api/v1/projects/#{options[:project_id]}/subscriptions").
         to_return(status: 403)
     end
+    
+    def stub_subscriptions_post(project_id, attributes = {})
+      stub_request(:post, "https://pushpad.xyz/api/v1/projects/#{project_id}/subscriptions").
+        with(body: hash_including(attributes)).
+        to_return(status: 201, body: attributes.to_json)
+    end
+
+    def stub_failing_subscriptions_post(project_id)
+      stub_request(:post, "https://pushpad.xyz/api/v1/projects/#{project_id}/subscriptions").
+        to_return(status: 403)
+    end
+    
+    def stub_subscription_patch(project_id, id, attributes = {})
+      stub_request(:patch, "https://pushpad.xyz/api/v1/projects/#{project_id}/subscriptions/#{id}").
+        with(body: hash_including(attributes)).
+        to_return(status: 200, body: attributes.to_json)
+    end
+
+    def stub_failing_subscription_patch(project_id, id)
+      stub_request(:patch, "https://pushpad.xyz/api/v1/projects/#{project_id}/subscriptions/#{id}").
+        to_return(status: 422)
+    end
+    
+    def stub_subscription_delete(project_id, id)
+      stub_request(:delete, "https://pushpad.xyz/api/v1/projects/#{project_id}/subscriptions/#{id}").
+        to_return(status: 204)
+    end
+    
+    def stub_failing_subscription_delete(project_id, id)
+      stub_request(:delete, "https://pushpad.xyz/api/v1/projects/#{project_id}/subscriptions/#{id}").
+        to_return(status: 403)
+    end
+    
+    describe ".create" do
+      it "creates a new subscription with the given attributes and returns it" do
+        attributes = {
+          endpoint: "https://example.com/push/f7Q1Eyf7EyfAb1", 
+          p256dh: "BCQVDTlYWdl05lal3lG5SKr3VxTrEWpZErbkxWrzknHrIKFwihDoZpc_2sH6Sh08h-CacUYI-H8gW4jH-uMYZQ4=",
+          auth: "cdKMlhgVeSPzCXZ3V7FtgQ==",
+          uid: "exampleUid", 
+          tags: ["exampleTag1", "exampleTag2"]
+        }
+        stub_subscriptions_post(5, attributes)
+
+        subscription = Subscription.create(attributes, project_id: 5)
+        expect(subscription).to have_attributes(attributes)
+      end
+      
+      it "fails with CreateError if response status code is not 201" do
+        attributes = { endpoint: "https://example.com/push/123" }
+        stub_failing_subscriptions_post(5)
+
+        expect {
+          Subscription.create(attributes, project_id: 5)
+        }.to raise_error(Subscription::CreateError)
+      end
+    end
 
     describe ".count" do
       it "returns value from X-Total-Count header" do
@@ -93,6 +160,46 @@ module Pushpad
       end
     end
     
+    describe ".find" do
+      it "returns subscription with attributes from json response" do
+        attributes = {
+          id: 5,
+          endpoint: "https://example.com/push/f7Q1Eyf7EyfAb1", 
+          p256dh: "BCQVDTlYWdl05lal3lG5SKr3VxTrEWpZErbkxWrzknHrIKFwihDoZpc_2sH6Sh08h-CacUYI-H8gW4jH-uMYZQ4=",
+          auth: "cdKMlhgVeSPzCXZ3V7FtgQ==",
+          uid: "exampleUid", 
+          tags: ["exampleTag1", "exampleTag2"],
+          last_click_at: "2023-11-03T10:30:00.000Z",
+          created_at: "2016-09-06T10:47:05.494Z"
+        }
+        stub_subscription_get(id: 5, project_id: 10, attributes: attributes)
+
+        subscription = Subscription.find(5, project_id: 10)
+
+        attributes.delete(:last_click_at)
+        attributes.delete(:created_at)
+        expect(subscription).to have_attributes(attributes)
+        expect(subscription.last_click_at.utc.to_s).to eq(Time.utc(2023, 11, 3, 10, 30, 0.0).to_s)
+        expect(subscription.created_at.utc.to_s).to eq(Time.utc(2016, 9, 6, 10, 47, 5.494).to_s)
+      end
+
+      it "fails with FindError if response status code is not 200" do
+        stub_failing_subscription_get(id: 5, project_id: 10)
+
+        expect {
+          Subscription.find(5, project_id: 10)
+        }.to raise_error(Subscription::FindError)
+      end
+      
+      it "fails with helpful error message when project_id is missing" do
+        Pushpad.project_id = nil
+
+        expect {
+          Subscription.find 5
+        }.to raise_error(/must set project_id/)
+      end
+    end
+    
     describe ".find_all" do
       it "returns subscriptions of project with attributes from json response" do
         attributes = {
@@ -197,5 +304,69 @@ module Pushpad
       end
     end
     
+    describe "#update" do
+      it "updates a subscription with the given attributes and returns it" do
+        attributes = {
+          uid: "exampleUid", 
+          tags: ["exampleTag1", "exampleTag2"]
+        }
+        stub_subscription_patch(5, 123, attributes)
+
+        subscription = Subscription.new(id: 123)
+        subscription.update attributes, project_id: 5
+        expect(subscription).to have_attributes(attributes)
+      end
+      
+      it "fails with UpdateError if response status code is not 200" do
+        attributes = { uid: "exampleUid" }
+        stub_failing_subscription_patch(5, 123)
+
+        subscription = Subscription.new(id: 123)
+        
+        expect {
+          subscription.update attributes, project_id: 5
+        }.to raise_error(Subscription::UpdateError)
+      end
+      
+      it "fails with helpful error message when project_id is missing" do
+        Pushpad.project_id = nil
+
+        expect {
+          Subscription.new(id: 123).update({})
+        }.to raise_error(/must set project_id/)
+      end
+      
+      it "fails with helpful error message when id is missing" do
+        Pushpad.project_id = 5
+        
+        expect {
+          Subscription.new(id: nil).update({})
+        }.to raise_error(/must set id/)
+      end
+    end
+    
+    describe "#delete" do
+      it "deletes a subscription" do
+        Pushpad.project_id = 5
+        stub_subscription_delete(5, 123)
+        
+        subscription = Subscription.new(id: 123)
+        
+        res = subscription.delete
+        expect(res).to be_nil
+      end
+      
+      it "fails with DeleteError if response status code is not 204" do
+        Pushpad.project_id = 5
+        stub_failing_subscription_delete(5, 123)
+        
+        subscription = Subscription.new(id: 123)
+        
+        expect {
+          subscription.delete
+        }.to raise_error(Subscription::DeleteError)
+      end
+    end
+    
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pushpad
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Pushpad
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-18 00:00:00.000000000 Z
+date: 2024-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -38,7 +38,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
+description:
 email:
 - support@pushpad.xyz
 executables: []
@@ -54,10 +54,12 @@ files:
 - Rakefile
 - lib/pushpad.rb
 - lib/pushpad/notification.rb
+- lib/pushpad/project.rb
 - lib/pushpad/request.rb
 - lib/pushpad/subscription.rb
 - pushpad.gemspec
 - spec/pushpad/notification_spec.rb
+- spec/pushpad/project_spec.rb
 - spec/pushpad/request_spec.rb
 - spec/pushpad/subscription_spec.rb
 - spec/pushpad_spec.rb
@@ -66,7 +68,7 @@ homepage: https://pushpad.xyz
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -81,13 +83,14 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 3.5.16
+signing_key:
 specification_version: 4
 summary: Web push notifications for Chrome, Firefox, Opera, Edge and Safari using
   Pushpad.
 test_files:
 - spec/pushpad/notification_spec.rb
+- spec/pushpad/project_spec.rb
 - spec/pushpad/request_spec.rb
 - spec/pushpad/subscription_spec.rb
 - spec/pushpad_spec.rb