Struct InviteService 

pub struct InviteService { /* private fields */ }

Service for managing collaboration invites.

Invites allow entity members to invite external collaborators via their four-word identity. The service enforces:

• Permission checks (must have Edit on Members)
• Role hierarchy (can’t grant higher role than own)
• CRDT persistence for offline-first sync

Implementations

impl InviteService

pub fn new( crdt_manager: Arc<CrdtManager>, entity_service: Arc<EntityService>, ) -> Self

Create a new invite service.

pub async fn create_invite( &self, creator_id: &str, request: InviteRequest, ) -> InviteServiceResult<Invite>

Create an invite to join an entity.

Arguments

• creator_id - Four-word identity of the invite creator
• request - The invite request containing recipient, entity, and role details

Errors

• PermissionDenied - Creator doesn’t have Edit on Members
• RoleEscalation - Trying to grant higher role than own
• InvalidFourWords - Invalid recipient identity format
• AlreadyMember - Recipient is already a member

pub async fn accept_invite( &self, recipient_id: &str, invite_id: &str, ) -> InviteServiceResult<()>

Accept a pending invite.

This adds the recipient as a member with the specified role.

Arguments

• recipient_id - Four-word identity of the recipient accepting
• invite_id - ID of the invite to accept

Errors

• InviteNotFound - Invite doesn’t exist
• PermissionDenied - Actor is not the recipient
• InviteExpired - Invite has expired
• AlreadyResolved - Invite already accepted/rejected/revoked

pub async fn reject_invite( &self, recipient_id: &str, invite_id: &str, ) -> InviteServiceResult<()>

Reject a pending invite.

Arguments

• recipient_id - Four-word identity of the recipient rejecting
• invite_id - ID of the invite to reject

Errors

• InviteNotFound - Invite doesn’t exist
• PermissionDenied - Actor is not the recipient
• AlreadyResolved - Invite already accepted/rejected/revoked

pub async fn revoke_invite( &self, revoker_id: &str, invite_id: &str, ) -> InviteServiceResult<()>

Revoke a pending invite.

Can be done by the creator or anyone with Edit on Members.

Arguments

• revoker_id - Four-word identity of the person revoking
• invite_id - ID of the invite to revoke

Errors

• InviteNotFound - Invite doesn’t exist
• PermissionDenied - Actor is not creator and lacks permissions
• AlreadyResolved - Invite already resolved

pub async fn list_pending_invites( &self, recipient_id: &str, ) -> InviteServiceResult<Vec<Invite>>

List pending invites for a recipient.

Returns all invites where the recipient matches and status is Pending.

pub async fn list_all_invites_for_recipient( &self, recipient_id: &str, ) -> InviteServiceResult<Vec<Invite>>

List all invites for a recipient (including resolved).

pub async fn list_entity_invites( &self, requester_id: &str, entity_type: EntityType, entity_id: &str, ) -> InviteServiceResult<Vec<Invite>>

List invites for an entity (admin view).

Requires at least ReadOnly on Members to view.

Arguments

• requester_id - Four-word identity of the person requesting
• entity_type - Type of entity
• entity_id - ID of the entity

Errors

• PermissionDenied - Requester lacks access to Members

pub async fn get_invite(&self, invite_id: &str) -> InviteServiceResult<Invite>

Get a single invite by ID.