jbr 3.12.0 → 3.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c97671522675aa1f7ae29743d5edb7188a49251adb4d485c50b144bfa64f27cf
-  data.tar.gz: 12c24e22c88f4880ed86c6b8377b34dafda2939e6ffd46b95a2f329cdcbc8c03
+  metadata.gz: eff06d450e1e4c357e208ca25d49eec46229009623dac5fab0d2316784b10ddc
+  data.tar.gz: 85cd26058f5eec17b84f143e61c1d366f2ac7702d44d0cd8b6fb80694041f6d3
 SHA512:
-  metadata.gz: 814518f518e0a4fb14f738462991b675c2f249f88e652fa76cb36e4685d00fd393250d8b4ec12256541ddd5318ecb30b23c712384fda2a6ee588b0ff2c2ba1fb
-  data.tar.gz: 9d8755f3c9ccab26b72f18d76d465f23fd949bf36b2f5d2dfe2a3a96d6f99d500c5e8fefb9ab019044205934dd0eb6dd1111762853087a9605e40257e13490f5
+  metadata.gz: 8cef0ee9b3d02ec476d890d6d34367d896e77ab374fa75f923d77fb6535415c3958c43aefea6ee7512e09606eb75cf92583c8c0ddf79e2ccf7d111b49a858af4
+  data.tar.gz: 1bdaf92404d72cf9ad5abaf26711e9cba47fa0054e1ab1e4b53114bfe0d157ed073959783ef8a23cdf101ac6ea95da798ca0e4723ffb06d907600b3857018aef

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [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

data/README.md

@@ -159,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
 ```

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

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

metadata

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