Feat/integrated ops count util (holochain#305)

* refactor: extract common logic of retry until complete or timeout into separate function, use in  and

* feat: util function integratedOpsCount to wait until the number of integrated Ops matches a target number, or else wait until timeout

* feat: add 'PrivateContent' entry type and create_private fn to fixture zome

* test: integratedOpsCount tests

* docs: rebuild docs

* chore: changelog

* chore: fn description comment

* chore: note breaking in changelog

* chore: cleanup test scenario

* chore: changelog accuracy

* chore: comment grammer

* chore: comment accuracy

* fix: op assertion numbers and clarifying comment

* chore: lint

* test: clarify workaround in integrateOpsCount test after reviewing again

* chore: changelog clobber

* feat: use 40s timeouts by default on utils fns

* test: ensure scenarios are cleaned up on failure

* test: bump flake lock, remove workaround that was fixed in holochain

* test: ensure scenario cleaned up

Author: mattyg

CHANGELOG.md

@@ -6,8 +6,11 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ### Added
 - A new optional field `label` was added to the types `AppWithOptions`, `ConductorOptions`, `CreateConductorOptions`, and to the function `addConductor`. It allows overriding the default label which will prefix log messages of that Conductor instance.
+- A new method `integratedOpsCount` that polls for integrated ops and checks if the number of integrated ops is equal to the desired number for a given dna hash. (#[305](https://github.com/holochain/tryorama/pull/305))
 
 ### Removed
+- **BREAKING**: Utility function `conductorCellsDhtSync` has been removed. Use `dhtSync` directly instead. (#[305](https://github.com/holochain/tryorama/pull/305))
+
 ### Changed
 - Log messages from Conductors that were created with `addPlayers` functions are now prefixed by `Tryorama - Player #` where "#" is the Player index. This makes it easier to distinguish log messages from different conductors. ([#302](https://github.com/holochain/tryorama/pull/302))
 

docs/tryorama.conductorcellsdhtsync.md

@@ -0,0 +1,119 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/tryorama](./tryorama.md) &gt; [integratedOpsCount](./tryorama.integratedopscount.md)
+
+## integratedOpsCount() function
+
+A utility function to wait until a player's integrated Ops count equals a desired count for a DNA
+
+**Signature:**
+
+```typescript
+integratedOpsCount: (player: PlayerApp, cellId: CellId, targetIntegratedOpsCount: number, intervalMs?: number, timeoutMs?: number) => Promise<void>
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+player
+
+
+</td><td>
+
+[PlayerApp](./tryorama.playerapp.md)
+
+
+</td><td>
+
+A Player.
+
+
+</td></tr>
+<tr><td>
+
+cellId
+
+
+</td><td>
+
+CellId
+
+
+</td><td>
+
+The Cell to check the integrated Ops count for.
+
+
+</td></tr>
+<tr><td>
+
+targetIntegratedOpsCount
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+The desired integrated Ops count to wait for.
+
+
+</td></tr>
+<tr><td>
+
+intervalMs
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+_(Optional)_ Interval between comparisons in milliseconds (default 500).
+
+
+</td></tr>
+<tr><td>
+
+timeoutMs
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+_(Optional)_ Timeout in milliseconds (default 40\_000).
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+Promise&lt;void&gt;
+
+A promise that resolves when the player's integrated ops count matches; rejects on timeout.
+

docs/tryorama.integratedopscount.md

@@ -101,17 +101,6 @@ A utility function to compare conductors' integrated DhtOps.
 Run the `hc` command to delete all conductor data.
 
 
-</td></tr>
-<tr><td>
-
-[conductorCellsDhtSync(conductorCells, intervalMs, timeoutMs)](./tryorama.conductorcellsdhtsync.md)
-
-
-</td><td>
-
-A utility function to wait until all conductors' integrated DhtOps are identical for a DNA.
-
-
 </td></tr>
 <tr><td>
 
@@ -178,6 +167,17 @@ A utility function to get the storage arc for a given player and dna hash.
 Get a shorthand function to call a cell's zome.
 
 
+</td></tr>
+<tr><td>
+
+[integratedOpsCount(player, cellId, targetIntegratedOpsCount, intervalMs, timeoutMs)](./tryorama.integratedopscount.md)
+
+
+</td><td>
+
+A utility function to wait until a player's integrated Ops count equals a desired count for a DNA
+
+
 </td></tr>
 <tr><td>