import * as plugins from '../loint-reception.plugins.js';

/**
 * A UserInvitation represents an invitation to join an organization.
 * Key characteristics:
 * - Unique by email (multiple orgs can share the same invitation)
 * - Converts to real User on registration or folds into existing user
 * - Auto-expires after 90 days
 */
export interface IUserInvitation {
  id: string;
  data: {
    /** The invited email address - unique key for sharing across orgs */
    email: string;

    /** Secure token for invitation link validation */
    token: string;

    /** Current status of the invitation */
    status: 'pending' | 'accepted' | 'expired' | 'cancelled';

    /** When the invitation was first created */
    createdAt: number;

    /** When the invitation expires (createdAt + 90 days) */
    expiresAt: number;

    /**
     * Organizations that have invited this email.
     * Multiple orgs can link to the same invitation.
     */
    organizationRefs: IOrganizationInvitationRef[];

    /** When the invitation was accepted (user registered/folded) */
    acceptedAt?: number;

    /** The User ID after conversion (when accepted) */
    convertedToUserId?: string;
  };
}

/**
 * Represents one organization's invitation to the user.
 * Stored as part of IUserInvitation.organizationRefs array.
 */
export interface IOrganizationInvitationRef {
  /** The organization that sent this invitation */
  organizationId: string;

  /** The user who sent the invitation */
  invitedByUserId: string;

  /** When this org invited the user */
  invitedAt: number;

  /** Roles to assign when the invitation is accepted */
  roles: string[];
}