jbr 1.0.6 → 1.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a5324bd1f1d013b3c4284542e4f5fb35437174789bd8e99a05eee9a9346811e
-  data.tar.gz: c18756f37f36bd03e476ff8e5e838418765e6a9d933bd54ff43bfebd1bd856d2
+  metadata.gz: 0e910cc53b4d0d49088e05481c72f0d828c97ecbea3e5c5a6a78da4d61988c7c
+  data.tar.gz: 8f9945fe6d165a8d6837a567433472e244f25236db495b714269454efb85a662
 SHA512:
-  metadata.gz: f7f5b06138be3b3cf73aca22357c841be01a2dee43731369007dd67901f47128cf79ea9bc3a5170903fe21cb7c8f01791df4c24333455890cc226b7a07b96846
-  data.tar.gz: 32520407af951f696fffb1f2107c3f40d49e42ae4e5a1c846779c8a43e74cbb04ee54a425e07c70c27e12f364522845d65e7b3ed597aef33aff5e3011ce56332
+  metadata.gz: f4996c8bea8e6596863240cb7caee1d59e8ade0aeaba02c059ac0ff8e770e062a94dc2ca385a399033b36f4da9a6ba0fcc8ab5c81ccb3a576f471e6b0d9d6a76
+  data.tar.gz: 0de414c6ece8eb9ce928c9431ed074472038efcf243d73af4262a43465fc1b128cb99f866f2d16956ff52f10a230cc05db3f54387e946f5d8fe4c01a02765d69

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [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/version.rb

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