jbr 3.10.0 → 3.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a315b6ba52c573f0d7fa1a0adec8145578550bd67a136071e7b8a02ea328ea1
-  data.tar.gz: 8c338c2f5a13ce4e98c99c2b5c11377274c71908a2b93fc6c114d8fb109ae540
+  metadata.gz: c97671522675aa1f7ae29743d5edb7188a49251adb4d485c50b144bfa64f27cf
+  data.tar.gz: 12c24e22c88f4880ed86c6b8377b34dafda2939e6ffd46b95a2f329cdcbc8c03
 SHA512:
-  metadata.gz: e82a0f7dac54170d4f791a752f7497d0b783dce98f4057c606c3ee1f5fe73c85ef32032eb297e2406b95d82bf531d6ba1cf2f4db8a9de5be1fbef38ac1c1c69b
-  data.tar.gz: 82a90ec3316204bb8ccf87c4d4011e249cd7b5d4484697fc30477f553bd4146baa9402bff10f4c6c2f893ce93bc7d06509831ecaf4a7d8a16a60dfad5b0ae67d
+  metadata.gz: 814518f518e0a4fb14f738462991b675c2f249f88e652fa76cb36e4685d00fd393250d8b4ec12256541ddd5318ecb30b23c712384fda2a6ee588b0ff2c2ba1fb
+  data.tar.gz: 9d8755f3c9ccab26b72f18d76d465f23fd949bf36b2f5d2dfe2a3a96d6f99d500c5e8fefb9ab019044205934dd0eb6dd1111762853087a9605e40257e13490f5

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [3.12.0] - 2026-08-28
+
+- [New] `Jbr::Account#name` and `#phone`, beside the `#id` it already answered. An app storing
+  which account it is connected to had nothing to show for it but a GID; the three are read in
+  one query the first time any of them is asked for. `Jbr.mock.account` names all three for a
+  test, and answers `account-01` for the ID where an app names none
+
+## [3.11.0] - 2026-08-19
+
+- [New] `Jbr::Property#latitude` and `#longitude`, reading the two the address already carried.
+  Every property query has asked Jobber for its `coordinates` for some time and `#address` has
+  answered them, but a caller wanting one had to open the hash -- and a mocked property answered
+  nothing for the whole address, so under `Jbr.mock` there was no way to reach them at all
+
 ## [3.8.0] - 2026-08-18
 
 - [New] `Jbr::Retriable`, a `Jbr::Error` for a query Jobber refused over what it costs rather

data/README.md

@@ -61,6 +61,15 @@ oauth.expires_at # => 2026-05-22 14:32:53
 oauth.account_id # => 'Z2lkOi8vSm9iYmV'
 ```
 
+Read the account they belong to, once, however much of it is asked for:
+
+```ruby
+account = oauth.account
+account.id # => 'Z2lkOi8vSm9iYmV'
+account.name # => 'Acme Plumbing'
+account.phone # => '(704) 459-7540', as Jobber holds it
+```
+
 Revoke credentials:
 
 ```ruby
@@ -215,6 +224,8 @@ visit.property.id # => 'Z2lkOi8vS'
 visit.property.street # => '1 Main St'
 visit.property.city # => 'Raleigh'
 visit.property.zip # => '27601'
+visit.property.latitude # => 35.77
+visit.property.longitude # => -78.63
 visit.property.address # => { street: '1 Main St', city: 'Raleigh', state: 'NC',
                        #      zip: '27601', latitude: 35.77, longitude: -78.63 }
 visit.property.client.name # => whoever the place sits on the file of
@@ -297,6 +308,12 @@ Mock a custom redirect URL:
 Jbr.mock.oauth_url = 'https://example.com'
 ```
 
+Mock the account the credentials belong to. Left unset, its ID is `account-01`:
+
+```ruby
+Jbr.mock.account = { id: 'account-01', name: 'Acme Plumbing', phone: '(704) 459-7540' }
+```
+
 ### Requests
 
 Mock successfully creating a request:

data/lib/jbr/account.rb

@@ -3,12 +3,21 @@ module Jbr
   class Account < Resource
     # The query that reads the account behind the current credentials.
     FIND = <<~GRAPHQL
-      { account { id } }
+      { account { id name phone } }
     GRAPHQL
 
-    # @return [String] the account ID, read once and remembered.
-    def id
-      @id ||= @oauth.query(FIND).dig 'account', 'id'
-    end
+    # @return [String, nil] the account ID.
+    def id = node['id']
+
+    # @return [String, nil] what the business calls itself.
+    def name = node['name']
+
+    # @return [String, nil] the number the business is reached on, as Jobber holds it.
+    def phone = node['phone']
+
+  private
+
+    # Read once and remembered, whichever of the three is asked for first.
+    def node = @node = @node.presence || @oauth.query(FIND).fetch('account', {})
   end
 end

data/lib/jbr/mock/account.rb

@@ -1,7 +1,15 @@
 module Jbr
-  # The one account every mocked set of credentials belongs to.
+  # The account that reads from {Jbr.mock} instead of Jobber.
   class Mock::Account < Account
-    # @return [String] the mocked account ID.
-    def id = 'account-01'
+    # @return [Object, nil] the values the app asked for, and 'account-01' for an ID it did not.
+    def id = node.fetch :id, 'account-01'
+
+    def name = node[:name]
+
+    def phone = node[:phone]
+
+  private
+
+    def node = Jbr.mock.account.to_h
   end
 end

data/lib/jbr/mock/property.rb

@@ -10,6 +10,10 @@ module Jbr
 
     def zip = @node[:zip]
 
+    def latitude = @node[:latitude]
+
+    def longitude = @node[:longitude]
+
     def client = Mock::Client.new(node: @node.fetch(:client, {}))
   end
 end

data/lib/jbr/mock.rb

@@ -2,6 +2,7 @@ module Jbr
   # What an app under test wants Jobber to answer.
   class Mock
     # The canned answers, each read by the matching Mock resource.
-    attr_accessor :quote, :job, :invoice, :request, :visits, :jobs, :oauth_url, :oauth_error
+    attr_accessor :account, :quote, :job, :invoice, :request, :visits, :jobs, :oauth_url,
+      :oauth_error
   end
 end

data/lib/jbr/property.rb

@@ -35,6 +35,12 @@ module Jbr
     # @return [String, nil] the postal code the work happens in.
     def zip = address[:zip]
 
+    # @return [Float, nil] how far north the work happens.
+    def latitude = address[:latitude]
+
+    # @return [Float, nil] how far east the work happens.
+    def longitude = address[:longitude]
+
     # The fields a match is made on. City and state are written but never matched:
     # Jobber holds whatever was typed, so "NC" and "North Carolina" -- or "Winston Salem"
     # and "Winston-Salem" -- would read as two homes. The ZIP already places the home.

data/lib/jbr/version.rb

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

metadata

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