@itm-studio/partner-sdk 0.3.4 → 0.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itm-studio/partner-sdk",
-  "version": "0.3.4",
+  "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.
@@ -1419,6 +1547,12 @@ type Query {
   Get public lineup invitation details by response token.
   """
   getMomentLineupByToken(token: String!): PublicMomentLineupInfo!
+  getPartnerPlans(input: GetPlansInput!): GetPlansResponse!
+  getPartnerPlan(planUid: String!): Plan!
+  getPartnerPlanBudgets(planUid: String!): [PlanBudgetSummary!]!
+  getPartnerPlanBudget(budgetUid: String!): PlanBudget!
+  getPartnerPlanningSource(offset: Int! = 0, take: Int! = 50, uid: String!): PlanningSource!
+  getPartnerPlanningProposal(uid: String!): PlanningProposal!
 }
 
 # ─── Input Types ──────────────────────────────────────────────────────────────
@@ -1825,4 +1959,458 @@ type Mutation {
   ): BrandSubscription!
 
   respondToMomentLineup(input: RespondToMomentLineupInput!): MomentLineupResponseResult!
+  preparePartnerPlanningProposal(input: PreparePlanningProposalInput!, toolCallId: String!): PlanningProposal!
+  decidePartnerPlanningProposal(approve: Boolean!, requestHash: String!, toolCallId: String!, uid: String!): PlanningProposal!
+}
+
+# Planning and budget artifacts
+input GetPlansInput {
+  cursor: String
+  kind: PlanKind
+  search: String
+  status: PlanStatus
+  tagNames: [String!]
+  take: Int
+}
+
+enum PlanKind {
+  GENERAL
+  LOCATION
+  MOMENT
+}
+
+enum PlanStatus {
+  ACTIVE
+  ARCHIVED
+}
+
+type GetPlansResponse {
+  hasNextPage: Boolean!
+  nextCursor: String
+  plans: [PlanSummary!]!
+  totalCount: Int!
+}
+
+type PlanSummary {
+  createdAt: DateTime!
+  description: String
+  kind: PlanKind!
+  moodboardItemCount: Int!
+  moodboardRevision: Int!
+  name: String!
+  revision: Int!
+  schedule: PlanSchedule
+  scheduleRevision: Int!
+  slug: String!
+  status: PlanStatus!
+  tags: [Tag!]!
+  uid: ID!
+  updatedAt: DateTime!
+}
+
+type PlanSchedule {
+  count: Int
+  createdAt: DateTime!
+  daysOfWeek: [Int!]!
+  endsAt: DateTime
+  endsOn: String
+  excludeDates: [String!]!
+  fingerprint: String!
+  frequency: MomentOccurrenceScheduleFrequency
+  includeDates: [String!]!
+  interval: Int
+  occurrenceCount: Int!
+  startsAt: DateTime
+  startsOn: String
+  times: [PlanScheduleTime!]!
+  timezone: String!
+  type: PlanScheduleType!
+  uid: ID!
+  updatedAt: DateTime!
+}
+
+enum MomentOccurrenceScheduleFrequency {
+  DAILY
+  MONTHLY
+  WEEKLY
+}
+
+type PlanScheduleTime {
+  durationMinutes: Int!
+  time: String!
+}
+
+enum PlanScheduleType {
+  ONE_TIME
+  RECURRING
+}
+
+type Plan {
+  createdAt: DateTime!
+  description: String
+  kind: PlanKind!
+  moodboard: PlanMoodboard
+  name: String!
+  revision: Int!
+  schedule: PlanSchedule
+  scheduleRevision: Int!
+  slug: String!
+  status: PlanStatus!
+  tags: [Tag!]!
+  uid: ID!
+  updatedAt: DateTime!
+}
+
+type PlanMoodboard {
+  createdAt: DateTime!
+  items: [PlanMoodboardItem!]!
+  revision: Int!
+  uid: ID!
+  updatedAt: DateTime!
+}
+
+type PlanMoodboardItem {
+  createdAt: DateTime!
+  linkMetadata: JSON
+  linkMetadataStatus: PlanLinkMetadataStatus!
+  linkUrl: String
+  mediaAsset: MediaAsset
+  note: String
+  position: Int!
+  title: String
+  type: PlanMoodboardItemType!
+  uid: ID!
+  updatedAt: DateTime!
+}
+
+enum PlanLinkMetadataStatus {
+  FAILED
+  NOT_APPLICABLE
+  PENDING
+  READY
+}
+
+enum PlanMoodboardItemType {
+  LINK
+  MEDIA
+}
+
+type PlanBudgetSummary {
+  createdAt: DateTime!
+  currencyCode: String!
+  currencyExponent: Int!
+  name: String!
+  planUid: String!
+  revision: Int!
+  scheduleIsStale: Boolean!
+  uid: ID!
+  updatedAt: DateTime!
+}
+
+type PlanBudget {
+  calculation: JSON!
+  createdAt: DateTime!
+  currencyCode: String!
+  currencyExponent: Int!
+  document: JSON!
+  name: String!
+  planUid: String!
+  revision: Int!
+  scheduleIsStale: Boolean!
+  uid: ID!
+  updatedAt: DateTime!
+}
+
+type PlanningSource {
+  contentHash: String
+  error: String
+  filename: String!
+  nextOffset: Int
+  sections: [PlanningSourceSection!]
+  status: String!
+  uid: String!
+  warnings: [String!]
+}
+
+type PlanningSourceSection {
+  reference: String!
+  values: [String!]!
+}
+
+type PlanningProposal {
+  expiresAt: DateTime!
+  preview: JSON!
+  requestHash: String!
+  result: JSON
+  status: String!
+  uid: String!
+}
+
+input PreparePlanningProposalInput {
+  budgetDraft: ReplacePlanBudgetDraftInput
+  budgetUid: String
+  createBudget: CreatePlanBudgetInput
+  createPlan: CreatePlanInput
+  expectedBudgetRevision: Int
+  expectedPlanRevision: Int
+  importUids: [String!]
+  planUid: String
+  reviewNotes: [String!]!
+  schedule: PlanScheduleInput
+  sourceDispositions: [PlanningSourceDispositionInput!]
+  tagNames: [String!]
+  updatePlan: UpdatePlanInput
+}
+
+input ReplacePlanBudgetDraftInput {
+  artistDeal: PlanBudgetArtistDealInput
+  averageTicketsPerCheckout: String
+  baselineSellThroughBps: Int
+  capacityAllocations: [PlanBudgetCapacityAllocationInput!]!
+  categories: [PlanBudgetCategoryInput!]!
+  externalTicketingChannels: [PlanBudgetExternalTicketingChannelInput!]
+  lines: [PlanBudgetLineInput!]!
+  physicalCapacity: Int
+  ticketTiers: [PlanBudgetTicketTierInput!]!
+  walkoutSellThroughBps: [Int!]
+}
+
+input PlanBudgetArtistDealInput {
+  basis: PlanBudgetArtistDealBasis!
+  guaranteeBasis: PlanBudgetGuaranteeBasis
+  guaranteeMinor: String
+  label: String
+  percentageBps: Int
+  type: PlanBudgetArtistDealType!
+  uid: String
+}
+
+enum PlanBudgetArtistDealBasis {
+  ORGANIZER_TICKET_REVENUE
+  ORGANIZER_TICKET_REVENUE_LESS_DEDUCTIBLE_EXPENSES
+}
+
+enum PlanBudgetGuaranteeBasis {
+  ONCE
+  PER_OCCURRENCE
+}
+
+enum PlanBudgetArtistDealType {
+  FLAT_GUARANTEE
+  GUARANTEE_VS_PERCENTAGE
+  PERCENTAGE
+}
+
+input PlanBudgetCapacityAllocationInput {
+  countsAsAttendee: Boolean!
+  label: String
+  position: Int!
+  quantity: Int!
+  type: PlanBudgetAllocationType!
+  uid: String
+}
+
+enum PlanBudgetAllocationType {
+  ARTIST_TEAM
+  COMP
+  GUEST_LIST
+  HOLD
+  OTHER
+  STAFF
+  SUPPORT
+}
+
+input PlanBudgetCategoryInput {
+  kind: PlanBudgetCategoryKind!
+  name: String!
+  parentUid: String
+  position: Int!
+  uid: String
+}
+
+enum PlanBudgetCategoryKind {
+  EXPENSE
+  REVENUE
+}
+
+input PlanBudgetExternalTicketingChannelInput {
+  assumptionsCapturedAt: DateTime
+  averageTicketsPerCheckout: String!
+  feeComponents: [PlanBudgetTicketingFeeComponentInput!]
+  name: String!
+  position: Int!
+  uid: String
+}
+
+input PlanBudgetTicketingFeeComponentInput {
+  assessment: PlanBudgetFeeAssessment!
+  fixedAmountMinor: String
+  kind: PlanBudgetFeeComponentKind!
+  label: String!
+  minimumAmountMinor: String
+  percentageBasis: PlanBudgetFeePercentageBasis!
+  position: Int!
+  rateBps: Int
+  treatment: PlanBudgetChargeTreatment!
+  uid: String
+}
+
+enum PlanBudgetFeeAssessment {
+  PER_TICKET
+  PER_TRANSACTION
+}
+
+enum PlanBudgetFeeComponentKind {
+  DELIVERY
+  FACILITY
+  OTHER
+  PLATFORM
+  PROCESSING
+}
+
+enum PlanBudgetFeePercentageBasis {
+  BUYER_SUBTOTAL
+  FACE_VALUE
+}
+
+enum PlanBudgetChargeTreatment {
+  ADDED_TO_BUYER
+  WITHHELD_FROM_ORGANIZER
+}
+
+input PlanBudgetLineInput {
+  actualTotalMinor: String
+  categoryUid: String!
+  committedTotalMinor: String
+  dealDeductible: Boolean
+  description: String
+  durationHours: String
+  formulaBasis: PlanBudgetLineBasis!
+  gratuityBps: Int
+  kind: PlanBudgetCategoryKind!
+  name: String!
+  paymentStatus: PlanBudgetPaymentStatus
+  plannedUnitAmountMinor: String!
+  position: Int!
+  quantity: String
+  quotedTotalMinor: String
+  repeatPerOccurrence: Boolean
+  taxBps: Int
+  uid: String
+  vendorLabel: String
+}
+
+enum PlanBudgetLineBasis {
+  FIXED
+  PER_ATTENDEE
+  PER_OCCURRENCE
+  PER_PAID_TICKET
+  PER_UNIT
+  PER_UNIT_PER_OCCURRENCE
+  RATE_X_TIME
+}
+
+enum PlanBudgetPaymentStatus {
+  NOT_APPLICABLE
+  NOT_STARTED
+  PAID
+  PARTIAL
+}
+
+input PlanBudgetTicketTierInput {
+  allocation: Int!
+  chargeRules: [PlanBudgetTicketChargeRuleInput!]
+  externalTicketingChannelUid: String
+  inputAmountMinor: String!
+  name: String!
+  position: Int!
+  pricingMode: PlanBudgetPricingMode!
+  roundingIncrementMinor: String
+  saleEndsAt: DateTime
+  saleStartsAt: DateTime
+  ticketingChannelType: PlanBudgetTicketingChannelType
+  uid: String
+}
+
+input PlanBudgetTicketChargeRuleInput {
+  amountMinor: String
+  calculation: PlanBudgetChargeCalculation!
+  kind: PlanBudgetChargeKind!
+  position: Int!
+  rateBps: Int
+  treatment: PlanBudgetChargeTreatment!
+  uid: String
+}
+
+enum PlanBudgetChargeCalculation {
+  FIXED_PER_TICKET
+  PERCENT_OF_FACE_VALUE
+}
+
+enum PlanBudgetChargeKind {
+  FEE
+  TAX
+}
+
+enum PlanBudgetPricingMode {
+  FACE_VALUE
+  ORGANIZER_NET_TARGET
+}
+
+enum PlanBudgetTicketingChannelType {
+  EXTERNAL
+  ITM
+  NONE
+}
+
+input CreatePlanBudgetInput {
+  currencyCode: String!
+  name: String!
+  templateUid: String
+}
+
+input CreatePlanInput {
+  description: String
+  kind: PlanKind!
+  name: String!
+  schedule: PlanScheduleInput
+  slug: String
+  tagNames: [String!]
+}
+
+input PlanScheduleInput {
+  count: Int
+  daysOfWeek: [Int!]
+  endsAt: DateTime
+  endsOn: String
+  excludeDates: [String!]
+  frequency: MomentOccurrenceScheduleFrequency
+  includeDates: [String!]
+  interval: Int
+  startsAt: DateTime
+  startsOn: String
+  times: [PlanScheduleTimeInput!]
+  timezone: String!
+  type: PlanScheduleType!
+}
+
+input PlanScheduleTimeInput {
+  durationMinutes: Int!
+  time: String!
+}
+
+input PlanningSourceDispositionInput {
+  disposition: String!
+  explanation: String!
+  importUid: String!
+  reference: String!
+  targetUids: [String!]
+}
+
+input UpdatePlanInput {
+  description: String
+  kind: PlanKind
+  name: String
+  slug: String
+  status: PlanStatus
 }