Skip to main content
Version: 🚧 Canary

📧 Invitation Blocks

Invitation blocks provide a comprehensive set of pre-configured components for managing user invitations in Nodeblocks applications. These blocks handle invitation creation, email delivery, token validation, and invitation lifecycle management.

🎯 Overview​

Invitation blocks are designed to:

  • Create and manage user invitations for organization access control
  • Send invitation emails with secure one-time tokens
  • Validate invitation tokens for secure acceptance workflows
  • Handle invitation lifecycle from creation to acceptance/deletion
  • Support organization-based invitation management

📦 Block Types​

🔍 Schemas​

JSON Schema definitions for invitation data validation:

  • invitationSchema: Base invitation data structure
  • createInvitationSchema: Invitation creation validation
  • getInvitationSchema: Single invitation retrieval
  • deleteInvitationSchema: Invitation deletion
  • findInvitationsSchema: Invitation search with filtering and pagination

View Invitation Schema Blocks →

⚙️ Handlers​

Core business logic for invitation operations:

  • createInvitation: Creates new invitation in database
  • sendInvitationEmail: Sends invitation email with token
  • findInvitations: Queries invitations with filtering
  • getInvitationById: Retrieves single invitation
  • updateInvitation: Updates invitation data
  • deleteInvitation: Removes invitation from database
  • buildCheckInvitationTokenPayload: Configures token validation
  • buildInvitationOnetimeTokenPayload: Prepares payload for OTT generation
  • getInvitationIdFromTokenInfo: Extracts invitation ID from token
  • verifyInvitationPayload: Verifies invitation authenticity
  • isPendingInvitation: Validates invitation status
  • buildAcceptInvitationPayload: Prepares acceptance data

View Invitation Handler Blocks →

🛣️ Routes​

HTTP endpoint definitions for invitation operations:

  • createInvitationRoute: POST /invitations - Create new invitation
  • getInvitationByIdRoute: GET /invitations/:invitationId - Get invitation
  • findInvitationsRoute: GET /invitations - List invitations
  • deleteInvitationRoute: DELETE /invitations/:invitationId - Delete invitation

View Invitation Route Blocks →

🚀 Features​

Complete invitation management features combining schemas, routes, and handlers:

  • createInvitationFeature: Invitation creation with email processing and token generation
  • getInvitationFeature: Invitation retrieval with validation
  • findInvitationsFeature: Invitation search with filtering and pagination
  • deleteInvitationFeature: Invitation deletion with proper validation and cleanup

View Invitation Feature Blocks →

🔗 Related Documentation​