jbr 2.3.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3bfdb96b9790f402fd9176cc2acbe42fec07d4a23e9b06b7f217297e2bfb6fcd
-  data.tar.gz: a09d5f78a7c996a1e6bf912b09ba1ee30c4f6805ac40b626848e79bb544104bd
+  metadata.gz: 131ece92fb051e64674afcd8e0066a126c83cd4502b7ea570795e2f6a456aaf6
+  data.tar.gz: d56615c6a47fab3de06ecebf672ade7f355e2338e263ff23577faea1b3dd744d
 SHA512:
-  metadata.gz: 941d93dd184d08aadfd4b4c454bed5945e28b9bd2600b8e3798515656286c4806effa7995d06f47fa37d43974925c629cb77c13528dd21264cbf1e77e2e8717d
-  data.tar.gz: 4b31eb73766e34a1aa60d9d7f0b0c4725257cb90f8e2ea1d28792b65fec581b30b43b03878c11328edd7e96cb0fef11b5e0b0a1fab827133fe12b2e69d17c436
+  metadata.gz: 12e0d034ad5a76d89bf9d8ded9b84bd5790197e34a709404c551f9b75d9d697dcaec066db7f9bd05283bb17fabbee9a5b1239f29b5ed90bb025141f47b9db88a
+  data.tar.gz: 1c3b8eff188c1a4ade48f273c6ec575bfe57a9906da717b8fba10237e3722317f04fc1bacbb333b06b2df4753e3dcf3c5e5d203a2d970908136d55098f3009d9

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [2.4.0] - 2026-08-08
+
+- [Breaking change] A visit answers `property` -- the ID Jobber files the place under, beside
+  the address fields -- rather than `property_id` and `address` apart. It reads the way
+  `client` already did, so a caller unpacks both the same way
+
 ## [2.3.0] - 2026-08-07
 
 - [Breaking change] A client's phone is the number Jobber holds as reachable rather than

data/README.md

@@ -98,12 +98,11 @@ visit = visits.first
 visit.id # => 'Z2lkOi8vS'
 visit.title # => 'Furnace tune-up'
 visit.job_id # => 'Z2lkOi8vS'
-visit.property_id # => 'Z2lkOi8vS'
+visit.property # => { id: 'Z2lkOi8vS', street: '1 Main St', city: 'Raleigh',
+               #      state: 'NC', zip: '27601', latitude: 35.77, longitude: -78.63 }
 visit.client # => { id: 'Z2lkOi8vS', first_name: 'Jane', last_name: 'Doe',
              #      phone: '5553335555', email: 'jane@example.com' }
              # phone is the reachable North American number, ten digits, or nil
-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
 visit.ends_at # => 2026-08-09 16:00:00
 visit.all_day? # => false
@@ -175,7 +174,8 @@ 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' },
+  property: { id: 'property-01', street: '1 Main St' },
+  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,11 +15,9 @@ 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 property = @node.fetch :property, {}
 
     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.3.0'
+  VERSION = '2.4.0'
 end

data/lib/jbr/visit.rb

@@ -51,9 +51,6 @@ 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
@@ -61,9 +58,13 @@ module Jbr
       fields.merge(phone: Phone.from(@node.dig('client', 'phones'))).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')
+    # Where the work happens, in the fields {Property} carries, under the ID Jobber files
+    # it by -- the shape {#client} answers in, so both read the same way.
+    # @return [Hash] any of :id, :street, :city, :state, :zip, :latitude and :longitude.
+    def property
+      fields = Property.fields_from @node.dig('property', 'address')
+      { id: @node.dig('property', 'id') }.merge fields
+    end
 
     # @return [Time, nil] the visit start time
     def starts_at

metadata

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