jbr 3.11.0 → 3.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85448f81e07f54907f8ea7dd6d3cd3c75cdc2b7283c282fee36a650a509140ba
-  data.tar.gz: 47ca67d4e752524a7c14109968e949ec23951925863d9785a6a7dcde38932094
+  metadata.gz: eff06d450e1e4c357e208ca25d49eec46229009623dac5fab0d2316784b10ddc
+  data.tar.gz: 85cd26058f5eec17b84f143e61c1d366f2ac7702d44d0cd8b6fb80694041f6d3
 SHA512:
-  metadata.gz: 61093edd19c3bd0b71472619e6b8cb5a9b2131571714ce2aa4091b0c0c51cb3c302ec8d8fed03b17f305cf147cb6f66fe32b3112ca890076a4d58ff08ce73907
-  data.tar.gz: db03655e533202b01e4a4b1d0c9d69e55fc66233996a622770ded307cf7d6d227eceb01504bb8af9604e619053cc7a1894a7b33f87cd50117f5e338c96cff8d2
+  metadata.gz: 8cef0ee9b3d02ec476d890d6d34367d896e77ab374fa75f923d77fb6535415c3958c43aefea6ee7512e09606eb75cf92583c8c0ddf79e2ccf7d111b49a858af4
+  data.tar.gz: 1bdaf92404d72cf9ad5abaf26711e9cba47fa0054e1ab1e4b53114bfe0d157ed073959783ef8a23cdf101ac6ea95da798ca0e4723ffb06d907600b3857018aef

data/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [3.13.0] - 2026-08-31
+
+- [New] `Jbr::LineItem#id`, `#description` and `#amount`, beside the `#quantity` and `#name` a
+  line already answered. The ID is how an app tells a line it has seen before from a new one,
+  the description is what the line says beyond what it is called, and the amount is what
+  Jobber calls `totalPrice`. Every query that lists lines now asks for all five, and a mocked
+  line answers whatever a test names for each
+
+## [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.

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
@@ -150,7 +159,10 @@ job.line_items # => an Array of the lines the job is made of
 line = job.line_items.first
 line.quantity # => 3, whole where Jobber's own Float has nothing after the point, and 3.5
               #    where it has: `3 Faucets`, or `3.5 Hours` for what was really billed
+line.id # => 'Njc5MjAw', the ID Jobber files the line by
 line.name # => 'Bathroom Faucet Installation'
+line.description # => 'Replace washers and reseat', what the line says beyond its name
+line.amount # => 285.0, what the line comes to -- what Jobber calls totalPrice
 line.to_s # => '3 Bathroom Faucet Installation', how many of what, and the name alone where
           #    Jobber holds no quantity for the line
 ```
@@ -299,6 +311,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/line_item.rb

@@ -1,8 +1,10 @@
 module Jbr
-  # One line of the work a job is made of: how many of a thing, and what it is called.
+  # One line of the work a job is made of: how many of a thing, what it is called,
+  # what it says, and what it comes to.
   class LineItem < Resource
-    # What Jobber calls each field of a line.
-    FIELDS = %w[quantity name]
+    # What Jobber calls each field of a line. The ID reads through {Resource#id}, so an app
+    # can tell a line it has seen before from a new one.
+    FIELDS = %w[id quantity name description totalPrice]
 
     # The most lines to read off one record. Bounded because Jobber prices a connection by the
     # page it is asked for and prices an unbounded one at its own maximum, so the lines of a
@@ -22,6 +24,12 @@ module Jbr
     # @return [String, nil] what the line is called.
     def name = @node['name']
 
+    # @return [String, nil] what the line says, beyond what it is called.
+    def description = @node['description']
+
+    # @return [Float, nil] what the line comes to — what Jobber calls `totalPrice`.
+    def amount = @node['totalPrice']
+
     # @return [String] how many of what: `3 Bathroom Faucet Installation`, and the name alone
     #   where Jobber holds no quantity for the line.
     def to_s = [ quantity, name ].compact.join ' '

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/line_item.rb

@@ -3,8 +3,14 @@ module Jbr
   class Mock::LineItem < LineItem
     # @return [Object, nil] the values the app asked for. The quantity is still read whole,
     #   so an app that mocks `3.0` of a thing sees the `3` a page would show.
+    def id = @node[:id]
+
     def quantity = whole @node[:quantity]
 
     def name = @node[:name]
+
+    def description = @node[:description]
+
+    def amount = @node[:amount]
   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/version.rb

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

metadata

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