company 3.1.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25ecca18513633e93192c25059e8b94701440313c7d2c57c507cc82737bca5c7
-  data.tar.gz: 7dafceaf23f066daf45ab29d79de66a829843a0d70f2cfbd958e3b0d6a6c53e7
+  metadata.gz: b4111f113a38cb47e0a7dcaeeb408f7a3bc3bfb112b53c756fd205e16c9f02da
+  data.tar.gz: '089082bab80c938007b47807f044d52247c65dc2885682a2f3a1c764947f72b3'
 SHA512:
-  metadata.gz: 515ccd1ff8052f0d2ae739c6c86eeb5ab1d21b6324cae13dd83a1dc0e4793a99d30f117380efcb893e95f512993261370b542f73025c85e475f76e96b93ae16d
-  data.tar.gz: 5c91bb934528ac9e0cd8d392b2b16e9aff925ac97730f45af02930b5c2316a77a09c17c685c7a4b4b95527b42f3d60cdf1158ca071e073c347c07757a24d5b54
+  metadata.gz: 64b0d8713cc0d6b0cbe7deedcf6a3361dccec22b529375d36509374e83ef1c5ca21c1307e6374d12b38bc125247877f93c5c3e73e5bf65a24e4c1f463129ec8a
+  data.tar.gz: 0a10c7540536d401f17c6e1adea9f34bbecb08b5aa4e1da737f6098968bcde7acb2cb208b763f7cd90b5e235d34e8c4e2cb37807c9f0bb7573ff8b35f906ac29

data/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 For more information about changelogs, check [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 4.0.0 - 2026-09-17
+
+- [Breaking change] `of` takes the ID a platform files a technician under rather than the
+  technician: `account.visits.of(technician.id)` is what `account.visits.of(technician)` was.
+  The ID is the whole of what any platform narrows by -- every gem read `.id` off the object
+  and nothing else -- and taking it plainly is what stops a caller holding a record of its own
+  from dressing it up as a technician it does not have.
+
+- [Note] The object invited a mistake that has already been made. An app passing its own
+  technician row had its database ID sent as the platform's, and the platform answered with
+  everybody's work rather than one person's -- quietly, and correctly as far as it knew. Named
+  as an ID, that is not something a caller can write by accident.
+
+## 3.1.0 - 2026-09-17
+
+- [Feature] `account.visits.for_work`, the stops of jobs and of leads together and the hours
+  held around them let go. A caller wanting both kinds had to ask twice and put the two lists
+  back together; a platform that files blocked-out time apart, and charges a sweep of every
+  page to read it, is now spared the sweep instead.
+
 ## 3.0.0 - 2026-09-16
 
 - [Breaking change] `Collection#assigned_to` is `Collection#of`. It read as it should on booked

data/README.md

@@ -100,10 +100,10 @@ technician.id                            # => 't1'
 technician.name                          # => 'Grace'
 technician.surname                       # => 'Hopper'
 
-week = account.visits.between(monday, sunday).of(technician)
+week = account.visits.between(monday, sunday).of(technician.id)
 week.ids                                 # => ['v1', 'v2', ...]
 
-free = account.windows.between(monday, sunday).of(technician)
+free = account.windows.between(monday, sunday).of(technician.id)
 free.first.starts_at                     # => 2026-09-16 13:00:00 UTC
 free.first.ends_at                       # => 2026-09-16 17:00:00 UTC
 
@@ -130,6 +130,9 @@ priced yet -- Jobber calls it an assessment, Housecall Pro an estimate -- names
 the same. `quote` stays the price, which is the other half of what Housecall Pro files as one
 record.
 
+`for_jobs`, `for_leads` and `for_work` narrow by what a stop was booked against: one kind, the
+other, or both and not the hours held around them.
+
 A window is the other half of the same question: not the hours somebody is out, but the ones
 they are not. It names no work and nobody going, a list of them having been narrowed to one
 technician already, and it is as long as it is -- cut it into offerable pieces where an offer is

data/lib/company/collection.rb

@@ -28,12 +28,15 @@ module Company
     def includes(*names) = self
 
     # A platform that can ask its server for one technician's work narrows the list there; one
-    # that cannot walks the list and keeps what the technician turns out to be on.
-    # @param technician [Technician] whoever the work is booked for.
+    # that cannot walks the list and keeps what they turn out to be on. It takes the ID the
+    # platform files them under rather than the technician, that being the whole of what any
+    # platform asks by: a caller holding a record of its own then names the ID it knows, rather
+    # than dressing it up as a technician it does not have.
+    # @param id [String] ID the platform files whoever the work is booked for under.
     # @return [Collection] the same list, narrowed to theirs.
-    def of(technician)
+    def of(id)
       Selection.new(collection: self) do |record|
-        record.technicians.any? { |each| each.id == technician.id }
+        record.technicians.any? { |technician| technician.id == id }
       end
     end
 

data/lib/company/collections/windows.rb

@@ -7,9 +7,9 @@ module Company
     # A window names nobody, a list of them having been narrowed to one technician already, so
     # there is nothing here to walk and keep: only the platform can tell one person's free time
     # from another's.
-    # @param technician [Technician] whose free time to answer.
+    # @param id [String] ID the platform files whoever is free under.
     # @return [Windows] the same list, as that technician's alone.
-    def of(technician)
+    def of(id)
       raise NotImplementedError, "#{self.class} does not answer one technician's windows"
     end
   end

data/lib/company/version.rb

@@ -1,5 +1,5 @@
 # The vocabulary two platform gems share: an account opens a business and the records it holds.
 module Company
   # The version of this gem, as RubyGems knows it.
-  VERSION = '3.1.0'
+  VERSION = '4.0.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: company
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Claudio Baccigalupo