@itm-studio/partner-sdk 0.3.5 → 0.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itm-studio/partner-sdk",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "TypeScript SDK for the ITM Partner API — typed GraphQL client with zero introspection required",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/schema/partner.graphql

@@ -438,6 +438,21 @@ enum TagSource {
   AUTO
 }
 
+enum ContributionStatus {
+  EXPIRED
+  FAILED
+  PENDING
+  PROCESSING
+  REVIEW_REQUIRED
+  SUCCEEDED
+}
+
+enum ContributionPageStatusFilter {
+  ACCEPTING
+  ARCHIVED
+  PAUSED
+}
+
 # ─── Types ───────────────────────────────────────────────────────────────────
 
 type Currency {
@@ -451,6 +466,75 @@ type Currency {
   updatedAt: DateTime!
 }
 
+"""
+A contribution (tip/donation) page owned by the partner's brand, with confirmed
+money totals. Amount fields are ITM cents (major units × 100, including
+zero-decimal currencies). Totals are strings because they can exceed Int.
+"""
+type ContributionPageAdmin {
+  uid: ID!
+  slug: String!
+  title: String!
+  description: String
+  """Legal/terms copy rendered beneath the page."""
+  finePrint: String
+  brandUid: String!
+  brandName: String!
+  brandSlug: String!
+  currency: Currency!
+  suggestedAmountsCents: [Int!]!
+  """Highlighted quick-pick; always one of suggestedAmountsCents."""
+  recommendedAmountCents: Int
+  minimumAmountCents: Int
+  maximumAmountCents: Int
+  requireItmAccount: Boolean!
+  """Shows an optional note field at checkout."""
+  allowContributorNote: Boolean!
+  isAccepting: Boolean!
+  """True when the page is accepting, not archived, and its payout account is verified."""
+  canContribute: Boolean!
+  """Public checkout URL for this page on ITM."""
+  publicUrl: String!
+  """Data URL of a QR code that resolves to publicUrl."""
+  qrCodeImageUrl: String!
+  archivedAt: DateTime
+  successfulContributionCount: Int!
+  """Number of successful refunds."""
+  refundCount: Int!
+  grossAmountCents: String!
+  refundedAmountCents: String!
+  """Brand net after platform and processing fees, reduced pro rata by successful refunds."""
+  netAmountCents: String!
+  createdAt: DateTime!
+  updatedAt: DateTime!
+}
+
+"""
+A single contribution to one of the brand's contribution pages.
+Only SUCCEEDED contributions represent confirmed money.
+"""
+type ContributionAdmin {
+  uid: ID!
+  contributionPageUid: String!
+  """Page title snapshotted at checkout."""
+  pageTitle: String!
+  donorName: String!
+  donorEmail: String!
+  """Note left by the contributor at checkout; null when none was given."""
+  note: String
+  currencyCode: String!
+  amountCents: Int!
+  refundedAmountCents: Int!
+  status: ContributionStatus!
+  paidAt: DateTime
+  """Paid without an ITM account."""
+  isGuest: Boolean!
+  """When a guest contribution was linked to an ITM account."""
+  claimedAt: DateTime
+  createdAt: DateTime!
+  updatedAt: DateTime!
+}
+
 """
 The authenticated partner's brand identity and public-facing details.
 The brand is derived from the partner token and cannot be selected by UID or slug.
@@ -883,6 +967,20 @@ type GetPartnerDropsResponse {
   nextCursor: String
 }
 
+type ContributionPagesResponse {
+  items: [ContributionPageAdmin!]!
+  totalCount: Int!
+  hasNextPage: Boolean!
+  nextCursor: String
+}
+
+type ContributionsResponse {
+  items: [ContributionAdmin!]!
+  totalCount: Int!
+  hasNextPage: Boolean!
+  nextCursor: String
+}
+
 type GetMomentLineupsResponse {
   lineups: [MomentLineup!]!
   totalCount: Int!
@@ -1382,6 +1480,36 @@ type Query {
     take: Int
   ): GetBrandEchoesForUserResponse!
 
+  """
+  Paginated contribution pages for the brand associated with the partner token,
+  newest first. Each page carries its public checkout URL and confirmed totals.
+  """
+  getPartnerContributionPages(
+    """ACCEPTING, PAUSED or ARCHIVED; omit for all pages."""
+    status: ContributionPageStatusFilter
+    """Case-insensitive search over title and slug."""
+    search: String
+    cursor: String
+    """1–100, default 25."""
+    take: Int
+  ): ContributionPagesResponse!
+
+  """
+  Paginated contributions for the brand associated with the partner token,
+  newest first. Filter status: SUCCEEDED for confirmed contributors.
+  """
+  getPartnerContributions(
+    """Restrict to one contribution page owned by the brand."""
+    contributionPageUid: String
+    """Omit for all statuses; SUCCEEDED lists paid contributions."""
+    status: ContributionStatus
+    """Case-insensitive search over donor name and email."""
+    search: String
+    cursor: String
+    """1–100, default 25."""
+    take: Int
+  ): ContributionsResponse!
+
   """
   Get paginated ticket tiers for a partner-owned moment.
   Provide either momentSlug or momentUid. Omitted isActive defaults to active tiers only.