Get user data (paywall.getUser)

/**
 * Represents a user's profile information
 */
interface User {
  /** Unique user identifier */
  id: string;
  /** User's email address */
  email: string;
  /** User's full name */
  name: string;
  /** URL to user's avatar image */
  avatar: string;
  /** ISO timestamp when user was created */
  created_at: string;
}

/**
 * Represents a balance type and count
 */
interface Balance {
  /** Type of tokens (e.g., 'standard', 'standard-2', 'advanced') */
  type: string;
  /** Amount of balance remaining */
  count: number;
}

/**
 * Represents a purchase/subscription information
 */
interface Purchase {
  /** Current status of the purchase/subscription */
  status: 'active' | 'paid' | 'pending' | 'unpaid' | 'canceled' | 
          'incomplete_expired' | 'past_due' | 'incomplete' | 'unpaid';
  /** ISO timestamp when current billing period started */
  current_period_start: string;
  /** ISO timestamp when current billing period ends */
  current_period_end: string;
  /** Whether subscription will cancel at period end */
  cancel_at_period_end: boolean;
  /** ISO timestamp when subscription was canceled, if applicable */
  canceled_at?: string;
  /** ISO timestamp when subscription was created */
  created: string;
  /** ISO timestamp when subscription ended, if applicable */
  ended_at?: string;
}

/**
 * Response structure for getUser method
 */
interface GetUserResponse {
  /** User profile information */
  user: User;
  /** Array of user's balance information */
  balances: Balance[];
  /** Whether user's country matches allowed countries */
  countryMatch: boolean;
  /** User's country tier level */
  tier: number;
  /** User's country code */
  country: string;
  /** Array of user's purchases/subscriptions */
  purchases: Purchase[];
  /** Whether user has active paid subscription or lifetime payment */
  paid: boolean;
}

interface Paywall {
  /**
   * Retrieves current user information including profile, balances, and purchase history.
   * 
   * @throws {Error} If the request fails or paywall is not initialized
   * 
   * @example
   * try {
   *   const userInfo = await paywall.getUser();
   *   
   *   if (userInfo.paid) {
   *     console.log('User has active subscription or lifetime payment');
   *   }
   *   
   *   // Check user's standard token balances
   *   const credits = userInfo.balances.find(b => b.type === 'standard');
   *   if (credits) {
   *     console.log(`User has ${credits.count} standard tokens`);
   *   }
   * } catch (error) {
   *   console.error('Failed to fetch user info:', error);
   * }
   */
  getUser(): Promise<GetUserResponse>;
}

Subscription statuses