@itm-studio/partner-sdk 0.3.6 → 0.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itm-studio/partner-sdk",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "TypeScript SDK for the ITM Partner API — typed GraphQL client with zero introspection required",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -49,8 +49,13 @@
   "devDependencies": {
     "@genql/cli": "^6.3.3",
     "@graphql-hive/cli": "^0.46.0",
+    "@types/pngjs": "^6.0.5",
+    "@types/qrcode": "^1.5.6",
     "esbuild": "0.27.3",
+    "jsqr": "^1.4.0",
     "msw": "^2.7.0",
+    "pngjs": "^7.0.0",
+    "qrcode": "^1.5.4",
     "tsup": "^8.4.0",
     "typescript": "^5.7.0",
     "vite": "^6.0.0",

package/schema/partner.graphql

@@ -509,6 +509,29 @@ type ContributionPageAdmin {
   updatedAt: DateTime!
 }
 
+enum ContributionSource {
+  STRIPE
+  OFF_SITE
+  POS
+}
+
+enum ManualContributionReceiptType {
+  REGULAR
+  DONATION
+}
+
+input CreateManualContributionInput {
+  sendReceipt: Boolean
+  currencyCode: String!
+  contributionPageUid: String!
+  amountCents: Int!
+  requestUid: String!
+  name: String!
+  email: String
+  phoneNumber: String
+  note: String
+}
+
 """
 A single contribution to one of the brand's contribution pages.
 Only SUCCEEDED contributions represent confirmed money.
@@ -519,7 +542,11 @@ type ContributionAdmin {
   """Page title snapshotted at checkout."""
   pageTitle: String!
   donorName: String!
-  donorEmail: String!
+  donorEmail: String
+  donorPhoneNumber: String
+  source: ContributionSource!
+  userUid: String
+  manualReceiptType: ManualContributionReceiptType
   """Note left by the contributor at checkout; null when none was given."""
   note: String
   currencyCode: String!
@@ -564,6 +591,18 @@ type Venue {
   updatedAt: DateTime!
 }
 
+"""
+Public location text for a moment, without the venue name or street address.
+Available even when the full venue is hidden until RSVP.
+"""
+type MomentPublicVenuePreview {
+  city: String!
+  """Display country label; use countryCode when an ISO country code is needed."""
+  country: String!
+  """ISO country code when available."""
+  countryCode: String
+}
+
 """
 A slim projection of the cover image media asset.
 Only the publicly useful fields (URL and MIME type) are exposed.
@@ -624,7 +663,10 @@ type Moment {
   lineupDisplayLabel: MomentLineupDisplayLabel!
   """Cover image for the moment. Null if no cover image is set."""
   coverImage: MomentCoverImage!
+  """Full venue details. Null when no venue is set or the caller cannot reveal it."""
   venue: Venue
+  """Public city/country location text. Null when no venue is set."""
+  publicVenuePreview: MomentPublicVenuePreview
   """Public tag assignments owned by the authenticated partner's brand."""
   momentTags(
     pagination: PaginationInput
@@ -686,6 +728,13 @@ type Ticket {
   uid: ID!
   price: Float!
   redeemedAt: DateTime
+  """
+  Opaque ticket payload to encode unchanged as a QR image for ITM scanners.
+  This is not an image URL. No decryption key is needed to render it.
+  Fetch on a trusted server, verify the app user's current ticket ownership,
+  and refetch before display because transfers can rotate the payload.
+  Rendering a QR does not establish admission eligibility; ITM validates it at scan time.
+  """
   encryptedQRCode: String!
   notes: String
   externalId: String
@@ -819,6 +868,17 @@ enum EventImportPlatform {
   EVENTBRITE
 }
 
+"""
+Match the current ITM ticket owner by exactly one of userUid, email, or phoneNumber.
+For an attendee app, derive this identifier from the authenticated user's verified
+ITM account association on your server; a caller-supplied identifier is not proof of ownership.
+"""
+input PartnerTicketUserLookupInput {
+  userUid: String
+  email: String
+  phoneNumber: String
+}
+
 input PartnerMomentAttendanceLookupInput {
   """
   ITM moment UID. Provide exactly one of momentUid, momentSlug, or externalPlatform with externalId.
@@ -1360,7 +1420,185 @@ type AgentMediaUploadReservation {
   mediaAsset: MediaAsset
 }
 
+enum MembershipBillingInterval {
+  MONTHLY
+  MONTHLY_OR_YEARLY
+  YEARLY
+}
+
+enum MembershipExpiryType {
+  FIXED_DATE
+  NO_EXPIRY
+  ROLLING
+}
+
+enum MembershipPassType {
+  ONE_TIME
+  RECURRING
+  RECURRING_OR_ONE_TIME
+}
+
+enum MembershipPurchaseType {
+  ONE_TIME
+  RECURRING
+}
+
+enum MembershipSource {
+  ADMIN_GRANT
+  IMPORT
+  PURCHASE
+}
+
+enum MembershipStatus {
+  ACTIVE
+  CANCELLED
+  EXPIRED
+  PAST_DUE
+  PENDING
+  REFUNDED
+}
+
+input GetPartnerMembersInput {
+  """Only memberships set (or not set) to cancel at period end"""
+  cancelAtPeriodEnd: Boolean
+  """Membership created strictly before this instant"""
+  createdAtBefore: DateTime
+  """Membership created at or after this instant"""
+  createdAtFrom: DateTime
+  """Current period ends strictly before this instant (e.g. expiring soon)"""
+  currentPeriodEndBefore: DateTime
+  """Current period ends at or after this instant"""
+  currentPeriodEndFrom: DateTime
+  """Cursor UID returned as nextCursor by the previous page"""
+  cursor: String
+  """
+  Restrict to these customer UIDs (PartnerMemberCustomer.uid, same as getPartnerAudience customer uid)
+  """
+  customerUids: [String!]
+  """Restrict to these membership tier UIDs (must belong to the brand)"""
+  membershipTierUids: [String!]
+  """
+  Case-insensitive search over member name, email, phone number, or exact membership number
+  """
+  search: String
+  sources: [MembershipSource!]
+  """
+  Membership statuses to include. Omit for every status except PENDING (unpaid checkout reservations).
+  """
+  statuses: [MembershipStatus!]
+  """Page size. Defaults to 50, maximum 100."""
+  take: Int
+}
+
+type GetPartnerMembersResponse {
+  hasNextPage: Boolean!
+  members: [PartnerMember!]!
+  nextCursor: String
+  totalCount: Int!
+}
+
+input GetPartnerMembershipTiersInput {
+  """Cursor UID returned as nextCursor by the previous page"""
+  cursor: String
+  isActive: Boolean
+  isPublic: Boolean
+  passTypes: [MembershipPassType!]
+  """Case-insensitive search over tier name and slug"""
+  search: String
+  """Page size. Defaults to 50, maximum 100."""
+  take: Int
+}
+
+type GetPartnerMembershipTiersResponse {
+  hasNextPage: Boolean!
+  membershipTiers: [PartnerMembershipTier!]!
+  nextCursor: String
+  totalCount: Int!
+}
+
+type PartnerMember {
+  billingInterval: MembershipBillingInterval
+  cancelAtPeriodEnd: Boolean!
+  cancelledAt: DateTime
+  createdAt: DateTime!
+  currentPeriodEnd: DateTime
+  currentPeriodStart: DateTime
+  customer: PartnerMemberCustomer!
+  """First issuance time; falls back to createdAt for legacy rows"""
+  issuedAt: DateTime!
+  membershipNumber: Int
+  membershipTier: PartnerMemberTier!
+  purchaseType: MembershipPurchaseType
+  quantity: Int!
+  refundedAt: DateTime
+  """Uses the member can redeem now; null means unlimited"""
+  remainingUses: Int
+  source: MembershipSource!
+  status: MembershipStatus!
+  uid: ID!
+  updatedAt: DateTime!
+}
+
+type PartnerMemberCustomer {
+  email: String
+  emailVerified: Boolean!
+  name: String
+  phoneNumber: String
+  uid: String!
+}
+
+type PartnerMemberTier {
+  name: String!
+  passType: MembershipPassType!
+  slug: String!
+  uid: String!
+}
+
+type PartnerMembershipTier {
+  """Memberships currently ACTIVE or PAST_DUE on this tier"""
+  activeMemberCount: Int!
+  benefits: [String!]!
+  billingInterval: MembershipBillingInterval
+  createdAt: DateTime!
+  """ISO 4217 currency code"""
+  currencyCode: String!
+  description: String
+  durationDays: Int
+  expiryType: MembershipExpiryType
+  fixedEndDate: DateTime
+  isActive: Boolean!
+  isPublic: Boolean!
+  memberLimit: Int
+  name: String!
+  """
+  Amount in hundredths of the currency's major unit (always x100, including zero-decimal currencies such as JPY)
+  """
+  oneTimePrice: Int
+  passType: MembershipPassType!
+  """
+  Amount in hundredths of the currency's major unit (always x100, including zero-decimal currencies such as JPY)
+  """
+  price: Int!
+  slug: String!
+  sortOrder: Int!
+  supplyCap: Int
+  totalUses: Int
+  trialDays: Int!
+  uid: ID!
+  updatedAt: DateTime!
+  """
+  Amount in hundredths of the currency's major unit (always x100, including zero-decimal currencies such as JPY)
+  """
+  yearlyPrice: Int
+}
+
 type Query {
+  """List the authenticated partner brand's membership rows; PENDING is excluded by default."""
+  getPartnerMembers(input: GetPartnerMembersInput): GetPartnerMembersResponse!
+
+  """List the authenticated partner brand's non-deleted membership tiers, including inactive and private tiers."""
+  getPartnerMembershipTiers(input: GetPartnerMembershipTiersInput): GetPartnerMembershipTiersResponse!
+
   """Get the authenticated agent operator email for the approval preview. Requires a brand-agent session with SEND_EMAIL; unavailable to partner API keys."""
   getPartnerAgentEmailContext: BrandAgentEmailContext!
   getAgentMediaUpload(uid: String!): AgentMediaUploadReservation!
@@ -1433,15 +1671,21 @@ type Query {
   ): PartnerMomentAttendanceStats
 
   """
-  Get paginated tickets for a moment.
+  Get confirmed tickets for a moment owned by the partner token's brand.
+  Use the user filter when retrieving an attendee's tickets for QR display.
+  The partner token authorizes brand access, not the app user's identity.
+  Follow hasNextPage/nextCursor to retrieve every ticket.
   """
   getPartnerTicketsForMoment(
     momentSlug: String!
     """Cursor UID for pagination"""
     cursor: String
+    """Page size. Defaults to 50; maximum 100."""
     take: Int
     """Filter by check-in status"""
     checkedIn: Boolean
+    """Match the current ticket owner by exactly one of userUid, email, or phoneNumber."""
+    user: PartnerTicketUserLookupInput
   ): GetTicketsResponse!
 
   """
@@ -1805,7 +2049,25 @@ input PostSubscriptionMessageInput {
   push: PostSubscriptionPushInput
 }
 
+input CreatePartnerBrandDropInput {
+  name: String!
+  subtitle: String
+  disclosures: String
+  isPublic: Boolean
+  """Only SUBSCRIBE is supported for partner-created drops."""
+  ctaType: BrandDropCtaType!
+  captureName: Boolean
+  captureEmail: Boolean
+  consentText: String
+  """Active image asset belonging to the authenticated brand."""
+  coverImageUid: String!
+  coverImageMobileUid: String
+  brandListUids: [String!]
+}
+
 input CreatePartnerBrandSubscriptionInput {
+  """Optional SUBSCRIBE drop UID belonging to the authenticated partner brand."""
+  dropUid: String
   compliance: SubscriptionComplianceInput
 
   """
@@ -1892,6 +2154,9 @@ type CreatePartnerBrandSubscriptionResponse {
 # ─── Mutations ────────────────────────────────────────────────────────────────
 
 type Mutation {
+  """Log a payment received off-site. Brand scope comes from the authenticated token or agent session. Amount is in ITM cents (major units times 100). Retain requestUid across retries."""
+  createPartnerManualContribution(input: CreateManualContributionInput!): ContributionAdmin!
+
   reserveAgentMediaUpload(input: ReserveAgentMediaUploadInput!): AgentMediaUploadReservation!
   finishAgentMediaUpload(uid: String!): Boolean!
 
@@ -1916,6 +2181,9 @@ type Mutation {
       reservationUid: String
   ): MediaAsset!
 
+  """Create a SUBSCRIBE drop for the authenticated partner brand."""
+  createPartnerBrandDrop(input: CreatePartnerBrandDropInput!): BrandDrop!
+
   """
   Subscribe a user to the authenticated partner brand.
   Set requireOtpVerification to true to start a two-step OTP flow.