jbr 1.0.5 → 1.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1acfc5eb08362100da536df933e8fdbde9edb2c3857970258731087766ebc9b1
-  data.tar.gz: 101d507d0b42e8c5f4f775db7e23ebbe4842ce5df46ced706dc7e4b261c41cac
+  metadata.gz: 0e910cc53b4d0d49088e05481c72f0d828c97ecbea3e5c5a6a78da4d61988c7c
+  data.tar.gz: 8f9945fe6d165a8d6837a567433472e244f25236db495b714269454efb85a662
 SHA512:
-  metadata.gz: b39be9586f32d4e4729999690569fbd806c96aa095ee899e5fcb3232308ee82376bf9e45bf1627dcc7822416698258b923e4c694fa4fe2b1c35be0e6e1087bde
-  data.tar.gz: c8904ce193f0694f17793560f3d1f29c7cdab60b3f19be34b04e96cb1097d5deee6bcfa83762e49371c2d3e6f41c38671461cc2c017f76e19a63a43005e797bb
+  metadata.gz: f4996c8bea8e6596863240cb7caee1d59e8ade0aeaba02c059ac0ff8e770e062a94dc2ca385a399033b36f4da9a6ba0fcc8ab5c81ccb3a576f471e6b0d9d6a76
+  data.tar.gz: 0de414c6ece8eb9ce928c9431ed074472038efcf243d73af4262a43465fc1b128cb99f866f2d16956ff52f10a230cc05db3f54387e946f5d8fe4c01a02765d69

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [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
+
 ## [1.0.5] - 2026-05-24
 
 - [Feature] Add mocks to help apps test Jobber integration

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/mock/oauth.rb

@@ -11,7 +11,7 @@ module Jbr
   private
 
     def self.post(_)
-      raise Error, error: Jbr.mock.oauth_error if Jbr.mock.oauth_error
+      raise Error, Jbr.mock.oauth_error if Jbr.mock.oauth_error
 
       { access_token: 'mock-token', refresh_token: 'mock-token', expires_at: (Time.current + 3600) }
     end

data/lib/jbr/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Jbr
-  VERSION = '1.0.5'
+  VERSION = '1.0.7'
 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.5
+  version: 1.0.7
 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