@itm-studio/partner-sdk 0.2.6 → 0.2.7

package/schema/partner.graphql

@@ -20,11 +20,37 @@ enum MomentSortOrder {
   DESC
 }
 
+enum BrandDropCtaType {
+  EXTERNAL_URL
+  GATED_LINK
+  MUSIC_LINK
+  SUBSCRIBE
+}
+
+enum MusicReleaseType {
+  ALBUM
+  EP
+  SINGLE
+}
+
 enum MomentType {
   DIGITAL
+  HYBRID
   IRL
 }
 
+enum MomentOnlineProvider {
+  GOOGLE_MEET
+  MS_TEAMS
+  OTHER
+  ZOOM
+}
+
+enum TicketAttendanceMode {
+  IN_PERSON
+  ONLINE
+}
+
 enum MomentCategory {
   ACTIVATION
   CONCERT
@@ -297,6 +323,24 @@ type Currency {
   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.
+"""
+type PartnerBrand {
+  uid: ID!
+  createdAt: DateTime!
+  updatedAt: DateTime!
+  name: String!
+  slug: String!
+  bio: String
+  publicUrl: String!
+  customDomain: String
+  customDomainVerifiedAt: DateTime
+  spotifyUrl: String
+  youtubeEmbedUrl: String
+}
+
 type Venue {
   uid: ID!
   name: String!
@@ -335,11 +379,13 @@ type Moment {
   soldOut: Boolean!
   timezone: String!
   minimumAge: Int!
+  """Tracks the overall capacity of the moment."""
+  capacity: Int
   externalUrl: String
   """Display label to use when rendering the public lineup section."""
   lineupDisplayLabel: MomentLineupDisplayLabel!
   """Cover image for the moment. Null if no cover image is set."""
-  coverImage: MomentCoverImage
+  coverImage: MomentCoverImage!
   venue: Venue
   ticketTiers: [TicketTier!]!
   createdAt: DateTime!
@@ -368,6 +414,7 @@ type TicketTier {
   description: String
   price: Float!
   currency: Currency!
+  attendanceMode: TicketAttendanceMode!
   isActive: Boolean!
   isPrivate: Boolean!
   maxPerUser: Int!
@@ -382,7 +429,7 @@ type TicketTier {
 type User {
   uid: ID!
   name: String
-  phoneNumber: String!
+  phoneNumber: String
   primaryEmail: String
   instagramProfile: String
   twitterProfile: String
@@ -531,6 +578,46 @@ type Echo {
   updatedAt: DateTime!
 }
 
+type BrandDrop {
+  uid: ID!
+  name: String!
+  slug: String!
+  subtitle: String
+  disclosures: String
+  isPublic: Boolean!
+  ctaType: BrandDropCtaType!
+  ctaUrl: String
+  ctaConfig: JSON
+  captureName: Boolean!
+  captureEmail: Boolean!
+  consentText: String
+  coverImage: MediaAsset!
+  coverImageMobile: MediaAsset
+  isActive: Boolean!
+  musicLink: BrandDropMusicLink
+  createdAt: DateTime!
+  updatedAt: DateTime!
+}
+
+type BrandDropMusicLink {
+  uid: ID!
+  releaseType: MusicReleaseType!
+  title: String!
+  artistName: String!
+  isrcCode: String
+  upcCode: String
+  releaseDate: DateTime
+  thumbnailUrl: String
+  thumbnailWidth: Int
+  thumbnailHeight: Int
+  subscriberOnly: Boolean!
+  sourceUrl: String!
+  odesliPageUrl: String
+  lastSyncedAt: DateTime
+  createdAt: DateTime!
+  updatedAt: DateTime!
+}
+
 # ─── Paginated Responses ─────────────────────────────────────────────────────
 
 type GetPublicMomentsResponse {
@@ -540,6 +627,13 @@ type GetPublicMomentsResponse {
   nextCursor: String
 }
 
+type GetPartnerDropsResponse {
+  drops: [BrandDrop!]!
+  totalCount: Int!
+  hasNextPage: Boolean!
+  nextCursor: String
+}
+
 type GetMomentLineupsResponse {
   lineups: [MomentLineup!]!
   totalCount: Int!
@@ -568,6 +662,201 @@ type GetBrandEchoesForUserResponse {
   nextCursor: String
 }
 
+type PartnerTicketTier {
+  """Sold-through fill rate as a 0-1 ratio."""
+  fillRate: Float!
+  isActive: Boolean!
+  isPrivate: Boolean!
+  label: String
+  labelColor: String
+  name: String!
+  price: Int!
+  facilityFee: Int!
+  remainingSupply: Int!
+  slotDate: DateTime
+  slotDurationHours: Int
+  supply: Int!
+  uid: String!
+}
+
+type GetPartnerTicketTiersForMomentResponse {
+  ticketTiers: [PartnerTicketTier!]!
+  totalCount: Int!
+  hasNextPage: Boolean!
+  nextCursor: String
+}
+
+enum DynamicPricingActorType {
+  ADMIN
+  PARTNER_API
+}
+
+enum DynamicPricingExecutionMode {
+  APPLY
+  PREVIEW
+}
+
+enum DynamicPricingBatchStatus {
+  APPLIED
+  CONFLICTED
+  FAILED
+  NO_CHANGES
+  PREVIEWED
+  PROCESSING
+  REJECTED
+}
+
+enum DynamicPricingBatchItemStatus {
+  APPLIED
+  BLOCKED_BY_BATCH
+  CONFLICTED
+  NO_CHANGE
+  REJECTED
+  WOULD_APPLY
+  WOULD_NOT_CHANGE
+  FAILED
+}
+
+enum DynamicPricingBatchEventType {
+  APPLIED
+  CONFLICTED
+  FAILED
+  IDEMPOTENCY_CONFLICT
+  NO_CHANGES
+  PREVIEWED
+  PROCESSING
+  RECEIVED
+  REJECTED
+  REPLAYED
+}
+
+enum DynamicPricingInventoryGuardMode {
+  INDEPENDENT
+  RANGE
+}
+
+enum DynamicPricingInventoryMetric {
+  REMAINING_SUPPLY
+  FILL_RATE_BPS
+}
+
+enum TicketAdmissionWindowSource {
+  EXPLICIT
+  LEGACY_SLOT
+  DEFAULT_MOMENT
+  MOMENT_OCCURRENCE
+}
+
+type MomentDynamicPricingTierRule {
+  uid: String!
+  ticketTierUid: String!
+  minPrice: Int!
+  maxPrice: Int!
+}
+
+type MomentDynamicPricingPolicy {
+  uid: String!
+  momentUid: String!
+  enabled: Boolean!
+  version: Int!
+  advanceBookingHorizonDays: Int!
+  tierRules: [MomentDynamicPricingTierRule!]!
+  createdAt: DateTime!
+  updatedAt: DateTime!
+}
+
+type DynamicPricingAdmissionWindow {
+  uid: String!
+  startsAt: DateTime!
+  endsAt: DateTime!
+  checkInOpensAt: DateTime
+  checkInClosesAt: DateTime
+  label: String
+  source: TicketAdmissionWindowSource!
+  sortOrder: Int!
+}
+
+type DynamicPricingTierContext {
+  ticketTierUid: String!
+  name: String!
+  currency: String!
+  currentPrice: Int!
+  facilityFee: Int!
+  minPrice: Int!
+  maxPrice: Int!
+  supply: Int!
+  remainingSupply: Int!
+  consumedSupply: Int!
+  fillRateBps: Int!
+  isActive: Boolean!
+  eligible: Boolean!
+  ineligibilityReasons: [String!]!
+  pricingContextVersion: String!
+  lastDynamicPriceChangeAt: DateTime
+  admissionWindows: [DynamicPricingAdmissionWindow!]!
+}
+
+type DynamicPricingContext {
+  serverNow: DateTime!
+  horizonEndsAt: DateTime!
+  validUntil: DateTime
+  momentUid: String!
+  momentSlug: String!
+  timezone: String!
+  policy: MomentDynamicPricingPolicy!
+  tiers: [DynamicPricingTierContext!]!
+}
+
+type DynamicPricingBatchItem {
+  uid: String!
+  ticketTierUid: String!
+  expectedPrice: Int!
+  requestedPrice: Int!
+  previousPrice: Int
+  resultingPrice: Int
+  expectedPricingContextVersion: String!
+  actualPricingContextVersion: String
+  status: DynamicPricingBatchItemStatus!
+  failureCode: String
+  failureMessage: String
+  contextSnapshot: JSON
+  externalSignals: JSON
+}
+
+type DynamicPricingBatchEvent {
+  uid: String!
+  type: DynamicPricingBatchEventType!
+  requestHash: String
+  details: JSON
+  createdAt: DateTime!
+}
+
+type DynamicPricingBatch {
+  uid: String!
+  momentUidRequested: String!
+  actorType: DynamicPricingActorType!
+  actorUid: String!
+  executionMode: DynamicPricingExecutionMode!
+  status: DynamicPricingBatchStatus!
+  idempotencyKey: String!
+  requestHash: String!
+  replayCount: Int!
+  idempotencyConflictCount: Int!
+  policyVersion: Int!
+  reason: String!
+  strategyKey: String
+  strategyVersion: String
+  externalReference: String
+  metadata: JSON
+  failureCode: String
+  failureMessage: String
+  items: [DynamicPricingBatchItem!]!
+  events: [DynamicPricingBatchEvent!]!
+  createdAt: DateTime!
+  updatedAt: DateTime!
+  completedAt: DateTime
+}
+
 type BrandSubscription {
   uid: ID!
   isActive: Boolean!
@@ -594,6 +883,11 @@ type MomentLineupResponseResult {
 # ─── Queries ─────────────────────────────────────────────────────────────────
 
 type Query {
+  """
+  Get details for the brand associated with the partner token.
+  """
+  getPartnerBrand: PartnerBrand!
+
   """
   Get paginated moments for the brand associated with the partner token.
   """
@@ -606,6 +900,19 @@ type Query {
     sortOrder: MomentSortOrder
   ): GetPublicMomentsResponse!
 
+  """
+  Get paginated drops for the brand associated with the partner token.
+  """
+  getPartnerDrops(
+    """Cursor UID for pagination"""
+    cursor: String
+    take: Int
+    """Case-insensitive search over name, subtitle, and slug"""
+    search: String
+    isPublic: Boolean
+    ctaType: BrandDropCtaType
+  ): GetPartnerDropsResponse!
+
   """
   Get a single moment by slug.
   """
@@ -659,6 +966,27 @@ type Query {
     take: Int
   ): GetBrandEchoesForUserResponse!
 
+  """
+  Get paginated ticket tiers for a partner-owned moment.
+  Provide either momentSlug or momentUid. Omitted isActive defaults to active tiers only.
+  """
+  getPartnerTicketTiersForMoment(
+    input: GetPartnerTicketTiersForMomentInput!
+  ): GetPartnerTicketTiersForMomentResponse!
+
+  """
+  Get a policy-bounded, admission-window-aware snapshot for dynamic pricing.
+  Use each tier's currentPrice and pricingContextVersion as apply preconditions.
+  """
+  getPartnerMomentDynamicPricingContext(
+    input: DynamicPricingMomentInput!
+  ): DynamicPricingContext!
+
+  """
+  Retrieve one dynamic pricing batch owned by the authenticated partner brand.
+  """
+  getPartnerDynamicPricingBatch(batchUid: String!): DynamicPricingBatch!
+
   """
   Get approved public lineup entries for a moment.
   Use getPartnerMoment to resolve a moment slug to uid before calling this query.
@@ -680,14 +1008,14 @@ type Query {
 # ─── Input Types ──────────────────────────────────────────────────────────────
 
 input DimensionsInput {
-  width: Int!
-  height: Int!
+  width: Float!
+  height: Float!
 }
 
 input VenueInput {
   name: String!
   city: String!
-  country: String!
+  country: String
   address: String
   postalCode: String
 }
@@ -710,30 +1038,139 @@ input CreatePartnerTicketTierInput {
   isPrivate: Boolean
   """Default: true."""
   isActive: Boolean
+  """
+  Required for HYBRID moments. Defaults from parent type for IRL and DIGITAL moments.
+  """
+  attendanceMode: TicketAttendanceMode
+}
+
+input CreateMomentOnlineConfigInput {
+  hostInstructions: String
+  meetingId: String
+  meetingPasscode: String
+  meetingUrl: String!
+  provider: MomentOnlineProvider!
 }
 
 input CreatePartnerMomentInput {
   name: String!
   description: String!
-  blurb: String!
+  blurb: String
   startDate: DateTime!
   endDate: DateTime!
   """IANA timezone (e.g. "America/New_York")."""
   timezone: String!
-  """IRL (in-person) or DIGITAL."""
+  """IRL (in-person), DIGITAL, or HYBRID."""
   type: MomentType!
   """UID of a previously uploaded media asset. If omitted, uses the brand default cover image."""
   coverImageUid: String
   """Required when type is IRL."""
   venue: VenueInput
+  """Allowed when type is DIGITAL or HYBRID."""
+  onlineConfig: CreateMomentOnlineConfigInput
   """Default: false."""
   isPrivate: Boolean
+  """Tracks the overall capacity of the moment."""
+  capacity: Int
   category: MomentCategory
   subcategory: MomentSubcategory
   """Ticket tiers to create along with the moment."""
   ticketTiers: [CreatePartnerTicketTierInput!]
 }
 
+input GetPartnerTicketTiersForMomentInput {
+  """Moment UID to search ticket tiers for. Provide this or momentSlug."""
+  momentUid: String
+  """Moment slug to search ticket tiers for. Provide this or momentUid."""
+  momentSlug: String
+  cursor: String
+  take: Int
+  """Optional ticket tier UIDs to return."""
+  ticketTierUids: [String!]
+  """Case-insensitive search over tier name and label."""
+  search: String
+  isActive: Boolean
+  isPrivate: Boolean
+  """
+  Filter by payment type: true = paid tiers only, false = free tiers only.
+  """
+  isPaid: Boolean
+  """Exact tier price in cents."""
+  price: Int
+  """Minimum tier price in cents."""
+  minPrice: Int
+  """Maximum tier price in cents."""
+  maxPrice: Int
+  supply: Int
+  minSupply: Int
+  maxSupply: Int
+  remainingSupply: Int
+  minRemainingSupply: Int
+  maxRemainingSupply: Int
+  """Minimum sold-through fill rate as a 0-1 ratio."""
+  minFillRate: Float
+  """Maximum sold-through fill rate as a 0-1 ratio."""
+  maxFillRate: Float
+  """Filter to tiers with an admission window ending after this date."""
+  startsAt: DateTime
+  """Filter to tiers with an admission window starting before this date."""
+  endsAt: DateTime
+  """Filter to tiers with slotDate on or after this date."""
+  slotDateStart: DateTime
+  """Filter to tiers with slotDate on or before this date."""
+  slotDateEnd: DateTime
+}
+
+input PartnerTicketTierUpdateInput {
+  ticketTierUid: String!
+  price: Int
+  facilityFee: Int
+  supply: Int
+}
+
+input EditPartnerTicketTiersForMomentInput {
+  """Moment UID containing the ticket tiers. Provide this or momentSlug."""
+  momentUid: String
+  """Moment slug containing the ticket tiers. Provide this or momentUid."""
+  momentSlug: String
+  updates: [PartnerTicketTierUpdateInput!]!
+}
+
+input DynamicPricingMomentInput {
+  momentUid: String
+  momentSlug: String
+}
+
+input DynamicPricingTierUpdateInput {
+  ticketTierUid: String!
+  newPrice: Int!
+  expectedPrice: Int!
+  expectedPricingContextVersion: String!
+  inventoryGuard: DynamicPricingInventoryGuardInput!
+  externalSignals: JSON
+}
+
+input DynamicPricingInventoryGuardInput {
+  mode: DynamicPricingInventoryGuardMode!
+  metric: DynamicPricingInventoryMetric
+  minimum: Int
+  maximum: Int
+}
+
+input ApplyDynamicPricingInput {
+  momentUid: String
+  momentSlug: String
+  mode: DynamicPricingExecutionMode!
+  idempotencyKey: String!
+  policyVersion: Int!
+  reason: String!
+  strategyKey: String
+  strategyVersion: String
+  externalReference: String
+  metadata: JSON
+  updates: [DynamicPricingTierUpdateInput!]!
+}
+
 input RespondToMomentLineupInput {
   token: String!
   status: MomentLineupStatus!
@@ -896,6 +1333,22 @@ type Mutation {
   """
   createPartnerMoment(input: CreatePartnerMomentInput!): Moment!
 
+  """
+  Bulk edit partner-owned ticket tiers for a moment.
+  Supports per-tier price, facility-fee, and supply updates.
+  """
+  editPartnerTicketTiersForMoment(
+    input: EditPartnerTicketTiersForMomentInput!
+  ): [PartnerTicketTier!]!
+
+  """
+  Preview or atomically apply absolute prices to explicitly selected,
+  policy-enrolled ticket tiers.
+  """
+  applyPartnerMomentDynamicPricing(
+    input: ApplyDynamicPricingInput!
+  ): DynamicPricingBatch!
+
   """
   Complete a partner brand subscription that was created with requireOtpVerification=true.
   """