Struct GroupInvite 

pub struct GroupInvite {
    pub id: String,
    pub group_id: GroupId,
    pub token_hash: String,
    pub role: GroupRole,
    pub created_by: String,
    pub created_at: u64,
    pub expires_at: u64,
    pub max_uses: Option<u32>,
    pub current_uses: u32,
    pub revoked: bool,
}

An invitation to join a group.

Invites use a token-based system where:

1. An admin creates an invite with a role
2. The invite generates a random token
3. The token is shared out-of-band (email, Slack, etc.)
4. The recipient joins using the token

Fields

id: String

Unique identifier for this invite.

group_id: GroupId

The group this invite is for.

token_hash: String

SHA256 hash of the invite token (never store plaintext).

role: GroupRole

Role to assign when the invite is used.

created_by: String

Email of the user who created the invite.

created_at: u64

When the invite was created (Unix timestamp).

expires_at: u64

When the invite expires (Unix timestamp).

max_uses: Option<u32>

Maximum number of times this invite can be used.

None means unlimited uses.

current_uses: u32

Number of times this invite has been used.

revoked: bool

Whether this invite has been revoked.

Implementations

impl GroupInvite

pub const DEFAULT_EXPIRY_SECS: u64

Default expiration time in seconds (7 days).

pub const DEFAULT_MAX_USES: u32 = 1

Default maximum uses for an invite.

pub fn new( group_id: GroupId, role: GroupRole, created_by: impl Into<String>, expires_in_secs: Option<u64>, max_uses: Option<u32>, ) -> (Self, String)

Creates a new invite for a group.

Returns both the invite and the plaintext token. The token should be shared with the invitee and never stored.

Arguments

• group_id - ID of the group to invite to
• role - Role to assign when joined
• created_by - Email of the admin creating the invite
• expires_in_secs - How long until the invite expires
• max_uses - Maximum number of uses (None for unlimited)

pub fn hash_token(token: &str) -> String

Hashes a token using SHA256.

pub fn is_valid(&self) -> bool

Checks if this invite is still valid.

pub fn verify_token(&self, token: &str) -> bool

Verifies a token against this invite’s hash.

Trait Implementations

impl Clone for GroupInvite

fn clone(&self) -> GroupInvite

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GroupInvite

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GroupInvite

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GroupInvite

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.