+ return DI::dba()->selectToArray('contact', [], $condition,
+ ['limit' => [$offset, $count], 'order' => [$shuffle ? 'RAND()' : 'name']]
+ );
+ }
+
+ /**
+ * Counts the number of contacts that are known mutuals with the provided public contact.
+ *
+ * @param int $cid Public contact id
+ * @param array $condition Additional condition array on the contact table
+ * @return int
+ * @throws Exception
+ */
+ public static function countMutuals(int $cid, array $condition = [])
+ {
+ $condition = DBA::mergeConditions($condition,
+ ['`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)
+ AND `id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`)',
+ $cid, $cid]
+ );
+
+ return DI::dba()->count('contact', $condition);
+ }
+
+ /**
+ * Returns a paginated list of contacts that are known mutuals with the provided public contact.
+ *
+ * @param int $cid Public contact id
+ * @param array $condition Additional condition on the contact table
+ * @param int $count
+ * @param int $offset
+ * @param bool $shuffle
+ * @return array
+ * @throws Exception
+ */
+ public static function listMutuals(int $cid, array $condition = [], int $count = 30, int $offset = 0, bool $shuffle = false)
+ {
+ $condition = DBA::mergeConditions($condition,
+ ['`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)
+ AND `id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`)',
+ $cid, $cid]
+ );
+
+ return DI::dba()->selectToArray('contact', [], $condition,
+ ['limit' => [$offset, $count], 'order' => [$shuffle ? 'RAND()' : 'name']]
+ );
+ }
+
+
+ /**
+ * Counts the number of contacts with any relationship with the provided public contact.
+ *
+ * @param int $cid Public contact id
+ * @param array $condition Additional condition array on the contact table
+ * @return int
+ * @throws Exception
+ */
+ public static function countAll(int $cid, array $condition = [])
+ {
+ $condition = DBA::mergeConditions($condition,
+ ['(`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)
+ OR `id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`))',
+ $cid, $cid]
+ );
+
+ return DI::dba()->count('contact', $condition);
+ }
+
+ /**
+ * Returns a paginated list of contacts with any relationship with the provided public contact.
+ *
+ * @param int $cid Public contact id
+ * @param array $condition Additional condition on the contact table
+ * @param int $count
+ * @param int $offset
+ * @param bool $shuffle
+ * @return array
+ * @throws Exception
+ */
+ public static function listAll(int $cid, array $condition = [], int $count = 30, int $offset = 0, bool $shuffle = false)
+ {
+ $condition = DBA::mergeConditions($condition,
+ ['(`id` IN (SELECT `relation-cid` FROM `contact-relation` WHERE `cid` = ? AND `follows`)
+ OR `id` IN (SELECT `cid` FROM `contact-relation` WHERE `relation-cid` = ? AND `follows`))',
+ $cid, $cid]
+ );
+
+ return DI::dba()->selectToArray('contact', [], $condition,