@itm-studio/partner-sdk 0.3.3 → 0.3.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itm-studio/partner-sdk",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "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

@@ -1245,9 +1245,27 @@ type GetPartnerMediaAssetsResponse {
   nextCursor: String
 }
 
+input ReserveAgentMediaUploadInput {
+  idempotencyKey: String!
+  toolCallId: String!
+  requestHash: String!
+}
+
+type AgentMediaUploadReservation {
+  uid: String!
+  mayGenerate: Boolean!
+  filename: String!
+  uploadUrl: String
+  downloadUrl: String!
+  uploaded: Boolean!
+  finishedAt: DateTime
+  mediaAsset: MediaAsset
+}
+
 type Query {
   """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!
 
   """Active brand-linked assets, newest first. Defaults to 50, capped at 100. READ_MEDIA for agents."""
   getPartnerMediaAssets(input: GetPartnerMediaAssetsInput!): GetPartnerMediaAssetsResponse!
@@ -1401,6 +1419,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 ──────────────────────────────────────────────────────────────
@@ -1740,6 +1764,9 @@ type CreatePartnerBrandSubscriptionResponse {
 # ─── Mutations ────────────────────────────────────────────────────────────────
 
 type Mutation {
+  reserveAgentMediaUpload(input: ReserveAgentMediaUploadInput!): AgentMediaUploadReservation!
+  finishAgentMediaUpload(uid: String!): Boolean!
+
   """
   Get a presigned S3 URL for direct file upload.
   Rate limited to 30 requests per minute.
@@ -1758,6 +1785,7 @@ type Mutation {
     idempotencyKey: String
     """Required for agent sessions; omit for partner tokens."""
     toolCallId: String
+      reservationUid: String
   ): MediaAsset!
 
   """
@@ -1803,4 +1831,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
 }