Spaces:
Runtime error
Runtime error
File size: 5,700 Bytes
46252cd | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 | <?php
declare(strict_types=1);
namespace OpenWA\Resources;
use OpenWA\Http\HttpExecutor;
/**
* Groups resource — WhatsApp group management.
*
* Backed by src/modules/group/group.controller.ts.
*/
class GroupsResource
{
private HttpExecutor $http;
public function __construct(HttpExecutor $http)
{
$this->http = $http;
}
/**
* @param array<string,mixed> $query
* @return array<int,array<string,mixed>>
*/
public function list(string $sessionId, array $query = []): array
{
return $this->http->request('GET', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups", $query) ?? [];
}
/** @return array<string,mixed> */
public function get(string $sessionId, string $groupId): array
{
return $this->http->request('GET', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}");
}
/**
* @param array<string,mixed> $body
* @return array<string,mixed>
*/
public function create(string $sessionId, array $body): array
{
return $this->http->request('POST', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups", [], $body);
}
/**
* Join a group via an invite code (the token from a chat.whatsapp.com/<code>
* link). Returns {success: true, groupId}.
*
* @return array<string,mixed>
*/
public function joinGroup(string $sessionId, string $inviteCode): array
{
return $this->http->request('POST', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/join", [], ['inviteCode' => $inviteCode]);
}
/** @return array<string,mixed> */
public function addParticipants(string $sessionId, string $groupId, array $participants): array
{
return $this->http->request('POST', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/participants", [], ['participants' => $participants]);
}
/** @return array<string,mixed> */
public function removeParticipants(string $sessionId, string $groupId, array $participants): array
{
return $this->http->request('DELETE', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/participants", [], ['participants' => $participants]);
}
/** @return array<string,mixed> */
public function promoteParticipants(string $sessionId, string $groupId, array $participants): array
{
return $this->http->request('POST', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/participants/promote", [], ['participants' => $participants]);
}
/** @return array<string,mixed> */
public function demoteParticipants(string $sessionId, string $groupId, array $participants): array
{
return $this->http->request('POST', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/participants/demote", [], ['participants' => $participants]);
}
/** @return array<string,mixed> */
public function setSubject(string $sessionId, string $groupId, string $subject): array
{
return $this->http->request('PUT', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/subject", [], ['subject' => $subject]);
}
/** @return array<string,mixed> */
public function setDescription(string $sessionId, string $groupId, string $description): array
{
return $this->http->request('PUT', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/description", [], ['description' => $description]);
}
/**
* Get group settings. Only the settings the active engine supports are
* present — any of {announce, locked, ephemeralSeconds} may be absent.
*
* @return array<string,mixed>
*/
public function getGroupSettings(string $sessionId, string $groupId): array
{
return $this->http->request('GET', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/settings");
}
/**
* Update group settings. At least one of {announce, locked,
* ephemeralSeconds} is required (400 otherwise); ephemeralSeconds responds
* 501 on engines without disappearing-message support (whatsapp-web.js).
*
* @param array<string,mixed> $settings
* @return array<string,mixed>
*/
public function updateGroupSettings(string $sessionId, string $groupId, array $settings): array
{
return $this->http->request('PUT', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/settings", [], $settings);
}
/** @return array<string,mixed> */
public function leave(string $sessionId, string $groupId): array
{
return $this->http->request('POST', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/leave");
}
/** @return array<string,mixed> */
public function inviteCode(string $sessionId, string $groupId): array
{
return $this->http->request('GET', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/invite-code");
}
/** @return array<string,mixed> */
public function revokeInviteCode(string $sessionId, string $groupId): array
{
return $this->http->request('POST', "/api/sessions/{$this->http->encodeSegment($sessionId)}/groups/{$this->http->encodeSegment($groupId)}/invite-code/revoke");
}
}
|