feat: Sponsorable#lifetimeReceivedSponsorshipValues (#887)

schema.d.ts

@@ -14191,6 +14191,11 @@ export type Organization = Actor & AnnouncementBanner & MemberStatusable & Node
    * either curated or that have been selected automatically based on popularity.
    */
   itemShowcase: ProfileItemShowcase;
+  /**
+   * Calculate how much each sponsor has ever paid total to this maintainer via
+   * GitHub Sponsors. Does not include sponsorships paid via Patreon.
+   */
+  lifetimeReceivedSponsorshipValues: SponsorAndLifetimeValueConnection;
   /** The organization's public profile location. */
   location?: Maybe<Scalars['String']['output']>;
   /** The organization's login name. */
@@ -14393,6 +14398,16 @@ export type OrganizationIsSponsoredByArgs = {
 };
 
 
+/** An account on GitHub, with one or more owners, that has repositories, members and teams. */
+export type OrganizationLifetimeReceivedSponsorshipValuesArgs = {
+  after?: InputMaybe<Scalars['String']['input']>;
+  before?: InputMaybe<Scalars['String']['input']>;
+  first?: InputMaybe<Scalars['Int']['input']>;
+  last?: InputMaybe<Scalars['Int']['input']>;
+  orderBy?: InputMaybe<SponsorAndLifetimeValueOrder>;
+};
+
+
 /** An account on GitHub, with one or more owners, that has repositories, members and teams. */
 export type OrganizationMannequinsArgs = {
   after?: InputMaybe<Scalars['String']['input']>;
@@ -23803,6 +23818,61 @@ export type SocialAccountProvider =
 /** Entities that can sponsor others via GitHub Sponsors */
 export type Sponsor = Organization | User;
 
+/**
+ * A GitHub account and the total amount in USD they've paid for sponsorships to a
+ * particular maintainer. Does not include payments made via Patreon.
+ */
+export type SponsorAndLifetimeValue = {
+  __typename?: 'SponsorAndLifetimeValue';
+  /** The amount in cents. */
+  amountInCents: Scalars['Int']['output'];
+  /** The amount in USD, formatted as a string. */
+  formattedAmount: Scalars['String']['output'];
+  /** The sponsor's GitHub account. */
+  sponsor: Organization | User;
+  /** The maintainer's GitHub account. */
+  sponsorable: Organization | User;
+};
+
+/** The connection type for SponsorAndLifetimeValue. */
+export type SponsorAndLifetimeValueConnection = {
+  __typename?: 'SponsorAndLifetimeValueConnection';
+  /** A list of edges. */
+  edges?: Maybe<Array<Maybe<SponsorAndLifetimeValueEdge>>>;
+  /** A list of nodes. */
+  nodes?: Maybe<Array<Maybe<SponsorAndLifetimeValue>>>;
+  /** Information to aid in pagination. */
+  pageInfo: PageInfo;
+  /** Identifies the total count of items in the connection. */
+  totalCount: Scalars['Int']['output'];
+};
+
+/** An edge in a connection. */
+export type SponsorAndLifetimeValueEdge = {
+  __typename?: 'SponsorAndLifetimeValueEdge';
+  /** A cursor for use in pagination. */
+  cursor: Scalars['String']['output'];
+  /** The item at the end of the edge. */
+  node?: Maybe<SponsorAndLifetimeValue>;
+};
+
+/** Ordering options for connections to get sponsor entities and associated USD amounts for GitHub Sponsors. */
+export type SponsorAndLifetimeValueOrder = {
+  /** The ordering direction. */
+  direction: OrderDirection;
+  /** The field to order results by. */
+  field: SponsorAndLifetimeValueOrderField;
+};
+
+/** Properties by which sponsor and lifetime value connections can be ordered. */
+export type SponsorAndLifetimeValueOrderField =
+  /** Order results by how much money the sponsor has paid in total. */
+  | 'LIFETIME_VALUE'
+  /** Order results by the sponsor's login (username). */
+  | 'SPONSOR_LOGIN'
+  /** Order results by the sponsor's relevance to the viewer. */
+  | 'SPONSOR_RELEVANCE';
+
 /** The connection type for Sponsor. */
 export type SponsorConnection = {
   __typename?: 'SponsorConnection';
@@ -23850,6 +23920,11 @@ export type Sponsorable = {
   isSponsoredBy: Scalars['Boolean']['output'];
   /** True if the viewer is sponsored by this user/organization. */
   isSponsoringViewer: Scalars['Boolean']['output'];
+  /**
+   * Calculate how much each sponsor has ever paid total to this maintainer via
+   * GitHub Sponsors. Does not include sponsorships paid via Patreon.
+   */
+  lifetimeReceivedSponsorshipValues: SponsorAndLifetimeValueConnection;
   /** The estimated monthly GitHub Sponsors income for this user/organization in cents (USD). */
   monthlyEstimatedSponsorsIncomeInCents: Scalars['Int']['output'];
   /** List of users and organizations this entity is sponsoring. */
@@ -23889,6 +23964,16 @@ export type SponsorableIsSponsoredByArgs = {
 };
 
 
+/** Entities that can sponsor or be sponsored through GitHub Sponsors. */
+export type SponsorableLifetimeReceivedSponsorshipValuesArgs = {
+  after?: InputMaybe<Scalars['String']['input']>;
+  before?: InputMaybe<Scalars['String']['input']>;
+  first?: InputMaybe<Scalars['Int']['input']>;
+  last?: InputMaybe<Scalars['Int']['input']>;
+  orderBy?: InputMaybe<SponsorAndLifetimeValueOrder>;
+};
+
+
 /** Entities that can sponsor or be sponsored through GitHub Sponsors. */
 export type SponsorableSponsoringArgs = {
   after?: InputMaybe<Scalars['String']['input']>;
@@ -28646,6 +28731,11 @@ export type User = Actor & Node & PackageOwner & ProfileOwner & ProjectOwner & P
    * either curated or that have been selected automatically based on popularity.
    */
   itemShowcase: ProfileItemShowcase;
+  /**
+   * Calculate how much each sponsor has ever paid total to this maintainer via
+   * GitHub Sponsors. Does not include sponsorships paid via Patreon.
+   */
+  lifetimeReceivedSponsorshipValues: SponsorAndLifetimeValueConnection;
   /** A user-curated list of repositories */
   lists: UserListConnection;
   /** The user's public profile location. */
@@ -28888,6 +28978,16 @@ export type UserIssuesArgs = {
 };
 
 
+/** A user is an individual's account on GitHub that owns repositories and can make new content. */
+export type UserLifetimeReceivedSponsorshipValuesArgs = {
+  after?: InputMaybe<Scalars['String']['input']>;
+  before?: InputMaybe<Scalars['String']['input']>;
+  first?: InputMaybe<Scalars['Int']['input']>;
+  last?: InputMaybe<Scalars['Int']['input']>;
+  orderBy?: InputMaybe<SponsorAndLifetimeValueOrder>;
+};
+
+
 /** A user is an individual's account on GitHub that owns repositories and can make new content. */
 export type UserListsArgs = {
   after?: InputMaybe<Scalars['String']['input']>;

schema.graphql

@@ -27454,6 +27454,37 @@ type Organization implements Actor & AnnouncementBanner & MemberStatusable & Nod
   """
   itemShowcase: ProfileItemShowcase!
 
+  """
+  Calculate how much each sponsor has ever paid total to this maintainer via
+  GitHub Sponsors. Does not include sponsorships paid via Patreon.
+  """
+  lifetimeReceivedSponsorshipValues(
+    """
+    Returns the elements in the list that come after the specified cursor.
+    """
+    after: String
+
+    """
+    Returns the elements in the list that come before the specified cursor.
+    """
+    before: String
+
+    """
+    Returns the first _n_ elements from the list.
+    """
+    first: Int
+
+    """
+    Returns the last _n_ elements from the list.
+    """
+    last: Int
+
+    """
+    Ordering options for results returned from the connection.
+    """
+    orderBy: SponsorAndLifetimeValueOrder = {field: SPONSOR_LOGIN, direction: ASC}
+  ): SponsorAndLifetimeValueConnection!
+
   """
   The organization's public profile location.
   """
@@ -47808,6 +47839,107 @@ Entities that can sponsor others via GitHub Sponsors
 """
 union Sponsor = Organization | User
 
+"""
+A GitHub account and the total amount in USD they've paid for sponsorships to a
+particular maintainer. Does not include payments made via Patreon.
+"""
+type SponsorAndLifetimeValue {
+  """
+  The amount in cents.
+  """
+  amountInCents: Int!
+
+  """
+  The amount in USD, formatted as a string.
+  """
+  formattedAmount: String!
+
+  """
+  The sponsor's GitHub account.
+  """
+  sponsor: Sponsorable!
+
+  """
+  The maintainer's GitHub account.
+  """
+  sponsorable: Sponsorable!
+}
+
+"""
+The connection type for SponsorAndLifetimeValue.
+"""
+type SponsorAndLifetimeValueConnection {
+  """
+  A list of edges.
+  """
+  edges: [SponsorAndLifetimeValueEdge]
+
+  """
+  A list of nodes.
+  """
+  nodes: [SponsorAndLifetimeValue]
+
+  """
+  Information to aid in pagination.
+  """
+  pageInfo: PageInfo!
+
+  """
+  Identifies the total count of items in the connection.
+  """
+  totalCount: Int!
+}
+
+"""
+An edge in a connection.
+"""
+type SponsorAndLifetimeValueEdge {
+  """
+  A cursor for use in pagination.
+  """
+  cursor: String!
+
+  """
+  The item at the end of the edge.
+  """
+  node: SponsorAndLifetimeValue
+}
+
+"""
+Ordering options for connections to get sponsor entities and associated USD amounts for GitHub Sponsors.
+"""
+input SponsorAndLifetimeValueOrder {
+  """
+  The ordering direction.
+  """
+  direction: OrderDirection!
+
+  """
+  The field to order results by.
+  """
+  field: SponsorAndLifetimeValueOrderField!
+}
+
+"""
+Properties by which sponsor and lifetime value connections can be ordered.
+"""
+enum SponsorAndLifetimeValueOrderField {
+  """
+  Order results by how much money the sponsor has paid in total.
+  """
+  LIFETIME_VALUE
+
+  """
+  Order results by the sponsor's login (username).
+  """
+  SPONSOR_LOGIN
+
+  """
+  Order results by the sponsor's relevance to the viewer.
+  """
+  SPONSOR_RELEVANCE
+}
+
 """
 The connection type for Sponsor.
 """
@@ -47907,6 +48039,37 @@ interface Sponsorable {
   """
   isSponsoringViewer: Boolean!
 
+  """
+  Calculate how much each sponsor has ever paid total to this maintainer via
+  GitHub Sponsors. Does not include sponsorships paid via Patreon.
+  """
+  lifetimeReceivedSponsorshipValues(
+    """
+    Returns the elements in the list that come after the specified cursor.
+    """
+    after: String
+
+    """
+    Returns the elements in the list that come before the specified cursor.
+    """
+    before: String
+
+    """
+    Returns the first _n_ elements from the list.
+    """
+    first: Int
+
+    """
+    Returns the last _n_ elements from the list.
+    """
+    last: Int
+
+    """
+    Ordering options for results returned from the connection.
+    """
+    orderBy: SponsorAndLifetimeValueOrder = {field: SPONSOR_LOGIN, direction: ASC}
+  ): SponsorAndLifetimeValueConnection!
+
   """
   The estimated monthly GitHub Sponsors income for this user/organization in cents (USD).
   """
@@ -58014,6 +58177,37 @@ type User implements Actor & Node & PackageOwner & ProfileOwner & ProjectOwner &
   """
   itemShowcase: ProfileItemShowcase!
 
+  """
+  Calculate how much each sponsor has ever paid total to this maintainer via
+  GitHub Sponsors. Does not include sponsorships paid via Patreon.
+  """
+  lifetimeReceivedSponsorshipValues(
+    """
+    Returns the elements in the list that come after the specified cursor.
+    """
+    after: String
+
+    """
+    Returns the elements in the list that come before the specified cursor.
+    """
+    before: String
+
+    """
+    Returns the first _n_ elements from the list.
+    """
+    first: Int
+
+    """
+    Returns the last _n_ elements from the list.
+    """
+    last: Int
+
+    """
+    Ordering options for results returned from the connection.
+    """
+    orderBy: SponsorAndLifetimeValueOrder = {field: SPONSOR_LOGIN, direction: ASC}
+  ): SponsorAndLifetimeValueConnection!
+
   """
   A user-curated list of repositories
   """