jbr 1.0.6 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a5324bd1f1d013b3c4284542e4f5fb35437174789bd8e99a05eee9a9346811e
-  data.tar.gz: c18756f37f36bd03e476ff8e5e838418765e6a9d933bd54ff43bfebd1bd856d2
+  metadata.gz: 5b22d779d7e688eaf8a64353655a11e880b961fee0dea0eafc4d56ae833dd77c
+  data.tar.gz: 8423c77d2b898f07d0125e66852f10373493d10ce09f37b3f489e581df2d73b0
 SHA512:
-  metadata.gz: f7f5b06138be3b3cf73aca22357c841be01a2dee43731369007dd67901f47128cf79ea9bc3a5170903fe21cb7c8f01791df4c24333455890cc226b7a07b96846
-  data.tar.gz: 32520407af951f696fffb1f2107c3f40d49e42ae4e5a1c846779c8a43e74cbb04ee54a425e07c70c27e12f364522845d65e7b3ed597aef33aff5e3011ce56332
+  metadata.gz: dded60918e2560621fde6a80ed20018f5aaf1d1391db9ba7144a12c11be90fc5bf5318dcfb16cab143c99d25cbc64fdfbf7f010c9560a5ca80e7eb7bd42e08a4
+  data.tar.gz: d5c5dfc9260eba1ec87c9fb6b05db5a039837820f01d544d1f07e438773f2f6e553be462e0ef594df07ffd77baca3c993537ef667cc43bcdf7138872eee76311

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [1.0.8] - 2026-05-26
+
+- [New] Add Jbr.client_id and Jbr.client_secret
+
+## [1.0.7] - 2026-05-26
+
+- [New] Add Jbr::Event to parse webhook payloads
+
 ## [1.0.6] - 2026-05-24
 
 - [Change] Return mock.oauth_error as the message of Jbr::Error

data/README.md

@@ -83,6 +83,17 @@ invoice.issued_at # => 2026-05-22 12:12:53
 invoice.completed_at # => 2026-05-22 14:32:53
 ```
 
+### Events
+
+Parse the payload of a Jobber event webhook:
+
+```ruby
+event = Jbr::Event.new data: { webHookEvent: { topic: 'JOB_CREATE', appId: 'app-1',
+  accountId: 'account-1', itemId: 'job-1', occurredAt: '2026-05-22T15:46:33Z' } }
+event.account_id = 'account-1
+event.item_id = 'job-1
+```
+
 ## Available mocks
 
 Use these methods to mock request to Jobber when testing an app:

data/lib/jbr/event.rb

@@ -0,0 +1,17 @@
+module Jbr
+  class Event
+    # @see https://developer.getjobber.com/docs/using_jobbers_api/setting_up_webhooks
+    SIGNATURE_HEADER = 'X-Jobber-Hmac-SHA256'
+
+    # @param params [Hash] the payload for an event webhook.
+    def initialize(params = {})
+      @params = params
+    end
+
+    # @return [String] unique identifier of the event target.
+    def item_id = @params.dig :data, :webHookEvent, :itemId
+
+    # @return [String] unique identifier of the event account.
+    def account_id = @params.dig :data, :webHookEvent, :accountId
+  end
+end

data/lib/jbr/oauth.rb

@@ -44,6 +44,12 @@ module Jbr
       new(credentials).tap { |oauth| oauth.account_id = oauth.account.id }
     end
 
+    # @return [String, nil] The client ID to interact with the API.
+    def self.client_id = ENV['JOBBER_CLIENT_ID']
+
+    # @return [String, nil] The client secret to interact with the API.
+    def self.client_secret = ENV['JOBBER_CLIENT_SECRET']
+
   private
 
     def refresh
@@ -65,10 +71,6 @@ module Jbr
         expires_at: (Time.current + output.fetch('expires_in', 3600).to_i) }
     end
 
-    def self.client_id = ENV['JOBBER_CLIENT_ID']
-
-    def self.client_secret = ENV['JOBBER_CLIENT_SECRET']
-
     def client
       GraphQL::Client.new endpoint: 'https://api.getjobber.com/api/graphql', token: @access_token, headers: headers
     end

data/lib/jbr/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Jbr
-  VERSION = '1.0.6'
+  VERSION = '1.0.8'
 end

data/lib/jbr.rb

@@ -30,3 +30,5 @@ require 'jbr/mock/account'
 require 'jbr/mock/url'
 
 require 'jbr/mocking'
+
+require 'jbr/event'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jbr
 version: !ruby/object:Gem::Version
-  version: 1.0.6
+  version: 1.0.8
 platform: ruby
 authors:
 - Claudio Baccigalupo
@@ -27,6 +27,7 @@ files:
 - lib/jbr/client.rb
 - lib/jbr/configuration.rb
 - lib/jbr/error.rb
+- lib/jbr/event.rb
 - lib/jbr/invoice.rb
 - lib/jbr/job.rb
 - lib/jbr/mock.rb