jbr 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6938d7f413fe243d95247911154afacb7ec9098710f784b9032bbf5bf3d60e37
-  data.tar.gz: 7b1b8c0f7b3b339ec96dd1f3343b75528a2a78755c752a0f779218746953b541
+  metadata.gz: c2e03e9b80223954e92497d75f84d2f6be78f23fadcbcfd7d82ba95e83ebacec
+  data.tar.gz: aac7754bb691e5b45ec8284a289eceacfc9afc961cbb71e6ffedc2f92a5fd2a9
 SHA512:
-  metadata.gz: 9f4b95151294dc8d1119bc51d5fe63544ca66a0d7073b65e1de0e6b315e9d7cffea572d21567aa05c94a9df5692e0460aa454f531e1a86967209b6e3f81c2d11
-  data.tar.gz: f1b7ed20d0eddab211e5a0ca5a68fbf6bfd25762ba20ccde8d76349e6a1fa986bc6dbc3cc062cced2947a8617fdd69cec3e33dcf8031158c24294fd0f8aaaff2
+  metadata.gz: 1a962bbdc7d20e9549fb10d55a5c52ddb1de7ce7c92a9da20e61162f040a8b2da35c2c6daa545c4ef67e36b04eec0085fa03faddf10db6435674390c20ddacde
+  data.tar.gz: e565f59d6f14284fd3919a048f770e060588be06850d225947b4552d88b1201ea7149afec5fe733f57d78afaa1809ea762f62377a7596729917381ecd7d65e7f

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [2.2.0] - 2026-08-07
+
+- [New] Carry the client a visit is for -- id, first name, last name, phone and email --
+  and the ID of the property it happens at, so an app can file a visit against the people
+  and places it already knows
+
 ## [2.1.0] - 2026-08-07
 
 - [New] Fetch the visits an account has scheduled from now on, with oauth.visits.upcoming.

data/README.md

@@ -98,6 +98,9 @@ visit = visits.first
 visit.id # => 'Z2lkOi8vS'
 visit.title # => 'Furnace tune-up'
 visit.job_id # => 'Z2lkOi8vS'
+visit.property_id # => 'Z2lkOi8vS'
+visit.client # => { id: 'Z2lkOi8vS', first_name: 'Jane', last_name: 'Doe',
+             #      phone: '5553335555', email: 'jane@example.com' }
 visit.address # => { street: '1 Main St', city: 'Raleigh', state: 'NC', zip: '27601',
               #      latitude: 35.77, longitude: -78.63 }
 visit.starts_at # => 2026-08-09 14:00:00
@@ -171,6 +174,7 @@ Mock successfully fetching upcoming visits:
 
 ```ruby
 Jbr.mock.visits = [ { id: 'visit-01', title: 'Furnace tune-up', job_id: 'job-01',
+  property_id: 'property-01', client: { id: 'client-01', first_name: 'Jane' },
   address: { street: '1 Main St', city: 'Raleigh', state: 'NC', zip: '27601' },
   starts_at: Date.tomorrow.noon, ends_at: Date.tomorrow.end_of_day,
   all_day: false, client_confirmed: true } ]

data/lib/jbr/mock/visit.rb

@@ -15,6 +15,10 @@ module Jbr
 
     def job_id = @node[:job_id]
 
+    def property_id = @node[:property_id]
+
+    def client = @node.fetch :client, {}
+
     def address = @node.fetch :address, {}
 
     def all_day? = @node[:all_day]

data/lib/jbr/version.rb

@@ -1,5 +1,5 @@
 # A Ruby client for the Jobber API.
 module Jbr
   # The version of this gem.
-  VERSION = '2.1.0'
+  VERSION = '2.2.0'
 end

data/lib/jbr/visit.rb

@@ -1,6 +1,11 @@
 module Jbr
   # One stop at a property: when the work on a job is scheduled to happen.
   class Visit < Resource
+    # What Jobber calls each field of the client the work is for, against what a caller reads.
+    CLIENT_FIELDS = { id: :id, firstName: :first_name, lastName: :last_name,
+      phone: :phone, email: :email,
+    }
+
     # The query that reads a page of visits starting after a moment, oldest first. Forty a
     # page, not a hundred: Jobber prices a query by its page size and refuses the wider one.
     UPCOMING = <<~GRAPHQL
@@ -9,7 +14,8 @@ module Jbr
           nodes {
             id title startAt endAt allDay clientConfirmed
             job { id }
-            property { address { #{Property::SELECTION} } }
+            client { #{CLIENT_FIELDS.keys.join ' '} }
+            property { id address { #{Property::SELECTION} } }
           }
           pageInfo { hasNextPage endCursor }
         }
@@ -47,6 +53,15 @@ module Jbr
     # @return [Boolean, nil] whether the client has confirmed the visit.
     def client_confirmed? = @node['clientConfirmed']
 
+    # @return [String, nil] the ID of the property the work happens at.
+    def property_id = @node.dig 'property', 'id'
+
+    # Who the work is for, in the fields a client is created with.
+    # @return [Hash] any of :id, :first_name, :last_name, :phone and :email.
+    def client
+      CLIENT_FIELDS.to_h { |jobber, ours| [ ours, @node.dig('client', jobber.to_s) ] }.compact
+    end
+
     # Where the work happens, in the fields {Property} carries.
     # @return [Hash] any of :street, :city, :state, :zip, :latitude and :longitude.
     def address = Property.fields_from @node.dig('property', 'address')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jbr
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.2.0
 platform: ruby
 authors:
 - Claudio Baccigalupo