hcp 4.0.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6452e662bc00ffd31b8fa21a935de8c1b4ef9d4779a87668ce4f6b4c4585b3b0
-  data.tar.gz: e9e8e77e53671ef7e822f2116d32a231ab6f71901de418bdd8643acd46232de5
+  metadata.gz: aad72b55ce034138806c6d68b993d430e7c299960ee14c92e0c59563b5f5bae3
+  data.tar.gz: ba0582ba808d0dbf087eb8a9f6823336e57d6fbc466a1be0f71a9daee38db25b
 SHA512:
-  metadata.gz: 4b03d7602db5e603bd0b0ba03c9031fb93f29bece4d5984a460f0fb4f79b5d7a740de189c4c0d281919650f39f5bf84e4019d8cc5988630114aaec5a59fdab45
-  data.tar.gz: 38068b949e79d8c8c26bbfe07f5c75546f4f11964a4ec9259eaab168df458423be6eac7575a070ed7cb91b0a529d3a11d22b6f2d2605decf7ea39d25847ad0c4
+  metadata.gz: da42001d35f67f6aa680b8b2b5f3cbc9ee020b537af8ba126ead44d76257d8f8f881afad501ecbce5c8c5fa7ebf65be59ccfb79f3d16ad2d5af5436288dd3c78
+  data.tar.gz: 680f9463a9f6540f03281fe4013251f83622811cfaff0a53bb1e9c47081720bc99f624be79ba86b0d9ce8031892c40f38cc140cf128711bc0cb0b800793ff4f8

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## [Unreleased]
 
+## [4.1.0] - 2026-09-17
+
+- [Feature] `account.visits.for_work`, the stops of jobs and of estimates together and the hours
+  held around them left unread. `/events` narrows by nothing, so reading blocked-out time costs
+  a sweep of every page on top of the two requests the work itself takes -- fifteen of them on
+  an account with 2,877 events. A caller that wants the work and not the holds now says so and
+  is spared them.
+
+- [Note] The vocabulary is `company` 3.1, where `for_work` is named. A platform that answers its
+  whole list at once gets the narrowing for free; this one pushes it down to the requests it
+  does not then make.
+
 ## [4.0.0] - 2026-09-16
 
 - [Breaking change] The vocabulary is `company` 3.0: `assigned_to` is `of`, so

data/README.md

@@ -118,8 +118,12 @@ for the stops of work alone:
 ```ruby
 account.visits.upcoming(2.weeks).for_jobs  # => only the appointments, one request
 account.visits.upcoming(2.weeks).for_leads # => only the estimates' slots, one request
+account.visits.upcoming(2.weeks).for_work  # => both kinds of stop, and no sweep
 ```
 
+`for_work` is the one to ask for where a caller wants the work and not the hours held around it:
+the jobs and the estimates are still read, and the fifteen requests of the sweep are not spent.
+
 A stop says where it is without being asked what it was booked for: an appointment has no
 address of its own and takes the job's, and an estimate's slot takes the estimate's. A caller
 reading a schedule never reaches through `visit.job` for an address.

data/lib/hcp/collections/visits.rb

@@ -44,6 +44,10 @@ module Hcp
     # @return [Visits] the same list, read off the estimates alone: one request rather than many.
     def for_leads = with(jobs: false, events: false)
 
+    # @return [Visits] the same list, read off the work alone: two requests rather than the
+    #   fifteen a sweep of the calendar costs on top of them.
+    def for_work = with(events: false)
+
     # Work booked across the window carries every stop in it, so each list is read once and
     # what was called off keeps its stops to itself.
     # @yield [Company::Visit] each visit in the window, the work's stops before the hours

data/lib/hcp/version.rb

@@ -1,5 +1,5 @@
 # The Housecall Pro API, answered in the vocabulary of the company gem.
 module Hcp
   # The version of this gem, as RubyGems knows it.
-  VERSION = '4.0.0'
+  VERSION = '4.1.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hcp
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.1.0
 platform: ruby
 authors:
 - Claudio Baccigalupo
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: ice_cube
   requirement: !ruby/object:Gem::Requirement