@itm-studio/partner-sdk 0.2.10 → 0.3.1

package/package.json

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

@@ -9,10 +9,21 @@ scalar JSON
 
 # ─── Enums ───────────────────────────────────────────────────────────────────
 
-enum MomentStatus {
-  UPCOMING
-  LIVE
-  ENDED
+enum ConsentStatus {
+  NEVER_SUBSCRIBED
+  SUBSCRIBED
+  UNSUBSCRIBED
+}
+
+enum UserSource {
+  BRAND
+  DICE
+  ITM
+}
+
+enum SortDirection {
+  ASC
+  DESC
 }
 
 enum BrandAgentEmailSendBatchStatus {
@@ -32,6 +43,21 @@ enum BrandAgentEmailSendMessageStatus {
   UNKNOWN
 }
 
+enum PartnerAudienceSortField {
+  CITY
+  CREATED_AT
+  NAME
+  NUM_MOMENTS
+  TOTAL_SPEND_USD
+  UPDATED_AT
+}
+
+enum MomentStatus {
+  UPCOMING
+  LIVE
+  ENDED
+}
+
 enum MomentSortOrder {
   ASC
   DESC
@@ -70,6 +96,8 @@ enum TicketAttendanceMode {
 
 enum MomentCategory {
   ACTIVATION
+  BUSINESS
+  COMMUNITY
   CONCERT
   DIGITAL
   DINING
@@ -96,6 +124,9 @@ enum MomentSubcategory {
   ALBUM_RELEASE_SHOW
   AMA
   ANNIVERSARY
+  APP_LAUNCH
+  ARTIST_POP_UP
+  ARTIST_RECEPTION
   ARTIST_TALK
   ART_FAIR
   ART_FESTIVAL
@@ -103,21 +134,30 @@ enum MomentSubcategory {
   AWARDS
   BAR_TAKEOVER
   BATTLE
+  BEAUTY_FASHION_EVENT
   BEER_AND_WINE_FESTIVAL
+  BEER_TASTING
   BIENNALE
   BIRTHDAY
   BLOCK_PARTY
+  BOOK_LAUNCH
+  BOOK_TALK
   BRAND_EXPERIENCE
   BRAND_REVEAL
   BREATHWORK
   BRUNCH_EVENT
   BURLESQUE
+  BUSINESS_MIXER
   CACAO_CEREMONY
+  CAREER_FAIR
   CARNIVAL
   CELEBRATION
   CHAMPIONSHIP
+  CHARITY_EVENT
   CHEF_DINNER
   CHOIR_OR_ENSEMBLE
+  CLASS
+  CLUB_MEETING
   CLUB_NIGHT
   CLUB_SET
   COLD_PLUNGE
@@ -126,12 +166,22 @@ enum MomentSubcategory {
   COMEDY_FESTIVAL
   COMEDY_NIGHT
   COMEDY_SHOW
+  COMMUNITY_FESTIVAL
+  COMMUNITY_MARKET
   COMMUNITY_MEETUP
   CONFERENCE
   COOKING_CLASS
+  COURSE
+  CREATOR_POP_UP
   CULTURAL_FESTIVAL
+  CULTURAL_GATHERING
+  DANCE_PARTY
   DANCE_PERFORMANCE
   DAYCLUB
+  DEMO_DAY
+  DESIGNER_MEET_AND_GREET
+  DESIGN_EXHIBITION
+  DINNER_PARTY
   DIRECTORS_CUT
   DISCORD_EVENT
   DOCUMENTARY
@@ -140,6 +190,7 @@ enum MomentSubcategory {
   ESPORTS
   EXHIBITION_GAME
   EXTREME_SPORTS
+  FAMILY_EVENT
   FAN_EXPERIENCE
   FAN_FEST
   FASHION_FESTIVAL
@@ -148,49 +199,77 @@ enum MomentSubcategory {
   FIGHT_NIGHT
   FILM_FESTIVAL
   FILM_PREMIERE
+  FILM_SCREENING
   FINISSAGE
   FIRESIDE_CHAT
   FITNESS_CLASS
   FITTING_EVENT
   FOOD_FESTIVAL
+  FOOD_MARKET
   FOOD_PAIRING
+  FOUNDER_MEETUP
+  FUNDRAISER
   GALLERY_OPENING
   GAME_DAY
+  GAME_LAUNCH
+  GAMING_STREAM
   GIVEAWAY
   GROUP_EXHIBITION
   GUERRILLA
   HACKATHON
   HEADLINER_SHOW
+  HIIT_CLASS
   HOLIDAY_PARTY
   HYBRID_EVENT
   IMMERSIVE_EXPERIENCE
   IMPROV_SHOW
+  INDUSTRY_PANEL
   INFLUENCER_EVENT
   INSTALLATION
   INTERACTIVE_INSTALLATION
+  INVESTOR_EVENT
+  JAM_SESSION
   JAZZ_NIGHT
   JAZZ_SESSION
+  JOB_FAIR
   KARAOKE_NIGHT
   KEYNOTE
   LATE_NIGHT_SET
+  LATIN_NIGHT
+  LECTURE
   LISTENING_PARTY
   LIVESTREAM
+  LIVE_AUDIO_ROOM
+  LIVE_PERFORMANCE
+  LIVE_PODCAST
+  LOCAL_MEETUP
   LOOKBOOK_SHOOT
+  MAGIC_SHOW
   MASQUERADE
   MASTERCLASS
   MEDITATION
   MEET_AND_GREET
   MEMBERS_ONLY
+  MIXOLOGY_CLASS
   MOBILE_TOUR
   MUSEUM_EVENT
   MUSICAL
   MUSIC_FESTIVAL
   MUSIC_VIDEO_PREMIERE
+  NETWORKING_EVENT
   NETWORKING_MIXER
   NFT_MINT
+  NUTRITION_WORKSHOP
+  OFFICE_HOURS
+  ONLINE_CLASS
+  ONLINE_COURSE
   ONLINE_DROP
+  ONLINE_LECTURE
+  ONLINE_OFFICE_HOURS
   ONLINE_PREMIERE
   ONLINE_WATCH_PARTY
+  OPEN_DECKS
+  OPEN_HOUSE
   OPEN_MIC
   OPERA
   ORCHESTRA
@@ -199,6 +278,10 @@ enum MomentSubcategory {
   PANEL
   PERFORMANCE_ART
   PHOTO_ACTIVATION
+  PHOTO_EXHIBITION
+  PICKUP_GAME
+  PILATES_CLASS
+  PITCH_NIGHT
   POOL_PARTY
   POP_UP_BOUTIQUE
   POP_UP_DINING
@@ -209,8 +292,11 @@ enum MomentSubcategory {
   PREVIEW
   PRIDE_FESTIVAL
   PRIVATE_EVENT
+  PRODUCT_DEMO
   PRODUCT_LAUNCH
+  Q_AND_A_SCREENING
   RAVE
+  READING
   RELEASE_PARTY
   RESIDENCY
   RESTAURANT_OPENING
@@ -225,41 +311,61 @@ enum MomentSubcategory {
   SAMPLING
   SECRET_DINING
   SEMINAR
+  SERIES_SCREENING
   SHORT_FILM
   SHOWCASE
   SHOWROOM
   SILENT_DISCO
+  SKATE_JAM
   SOCIAL_CHALLENGE
   SOLO_EXHIBITION
+  SONGWRITER_ROUND
   SOUND_BATH
   SPA_EXPERIENCE
   SPOKEN_WORD
   SPONSORSHIP
   SPORTS_CLINIC
+  SPORTS_TRAINING
   SPORTS_WATCH_PARTY
   STANDUP_COMEDY
+  STORYTELLING
+  STREAMING_RELEASE
   STREET_TEAM
   STUDIO_VISIT
+  STUDY_GROUP
+  STYLING_SESSION
   SUMMIT
   SUPPER_CLUB
   TAILGATE
   TASTING
+  TECH_FESTIVAL
   THEATER
   THEMED_NIGHT
   TOURNAMENT
   TOUR_STOP
+  TOWN_HALL
+  TRADE_SHOW
+  TRAINING
   TRIBUTE_SHOW
   TRUNK_SHOW
+  TV_PREMIERE
   TWITTER_SPACE
   VARIETY_SHOW
   VENUE_OPENING
   VIRTUAL_CONCERT
   VIRTUAL_EVENT
+  VIRTUAL_EXPO
+  VIRTUAL_MEETUP
+  VIRTUAL_NETWORKING
+  VIRTUAL_SUMMIT
+  VIRTUAL_WORKSHOP
+  VOLUNTEER_EVENT
   WAREHOUSE_PARTY
   WATCH_PARTY
   WEBINAR
   WELLNESS_FESTIVAL
   WELLNESS_WORKSHOP
+  WINE_TASTING
   WORKSHOP
   YOGA_SESSION
 }
@@ -327,6 +433,11 @@ enum TicketExtensionStatus {
   REFUNDED
 }
 
+enum TagSource {
+  MANUAL
+  AUTO
+}
+
 # ─── Types ───────────────────────────────────────────────────────────────────
 
 type Currency {
@@ -380,6 +491,32 @@ type MomentCoverImage {
   mimeType: String!
 }
 
+type Tag {
+  uid: ID!
+  name: String!
+  createdAt: DateTime!
+  updatedAt: DateTime!
+}
+
+type MomentTagAssignment {
+  tag: Tag!
+  source: TagSource!
+  isPublic: Boolean!
+  confidence: Float!
+}
+
+type GetMomentTagAssignmentsResponse {
+  assignments: [MomentTagAssignment!]!
+  totalCount: Int!
+  hasNextPage: Boolean!
+  nextCursor: String
+}
+
+input PaginationInput {
+  cursor: String
+  take: Float
+}
+
 type Moment {
   uid: ID!
   name: String!
@@ -404,6 +541,11 @@ type Moment {
   """Cover image for the moment. Null if no cover image is set."""
   coverImage: MomentCoverImage!
   venue: Venue
+  """Public tag assignments owned by the authenticated partner's brand."""
+  momentTags(
+    pagination: PaginationInput
+    sources: [TagSource!]
+  ): GetMomentTagAssignmentsResponse!
   ticketTiers: [TicketTier!]!
   createdAt: DateTime!
   updatedAt: DateTime!
@@ -514,6 +656,28 @@ type PartnerCustomer {
   tickets: [Ticket!]!
 }
 
+type PartnerAudienceCustomer {
+  uid: String!
+  name: String
+  email: String
+  emailVerified: Boolean!
+  phoneNumber: String
+  city: String
+  country: String
+  source: UserSource!
+  isSubscribed: Boolean!
+  emailConsentStatus: ConsentStatus!
+  smsConsentStatus: ConsentStatus!
+  communicationsOptedOut: Boolean!
+  isSuppressed: Boolean!
+  totalSpendUsdCents: Int!
+  numMoments: Int!
+  numProducts: Int!
+  numEchoes: Int!
+  createdAt: DateTime!
+  updatedAt: DateTime!
+}
+
 type PartnerMomentStats {
   generatedAt: DateTime!
   ticketsCount: Int!
@@ -740,6 +904,13 @@ type GetPartnerCustomersResponse {
   nextCursor: String
 }
 
+type GetPartnerAudienceResponse {
+  customers: [PartnerAudienceCustomer!]!
+  hasNextPage: Boolean!
+  nextCursor: String
+  totalCount: Int
+}
+
 type GetBrandEchoesForUserResponse {
   echoes: [Echo!]!
   totalCount: Int!
@@ -977,6 +1148,46 @@ input PartnerMomentsFiltersInput {
   includePrivate: Boolean
 }
 
+input PartnerAudienceFiltersInput {
+  customerUids: [String!]
+  search: String
+  hasEmail: Boolean
+  hasPhone: Boolean
+  isSubscribed: Boolean
+  emailConsentStatuses: [ConsentStatus!]
+  smsConsentStatuses: [ConsentStatus!]
+  communicationsOptedOut: Boolean
+  isSuppressed: Boolean
+  sources: [UserSource!]
+  cities: [String!]
+  countries: [String!]
+  createdAtFrom: DateTime
+  createdAtBefore: DateTime
+  updatedAtFrom: DateTime
+  updatedAtBefore: DateTime
+  minTotalSpendUsdCents: Int
+  maxTotalSpendUsdCents: Int
+  minNumMoments: Int
+  maxNumMoments: Int
+  momentUids: [String!]
+  ticketTierUids: [String!]
+  brandListUids: [String!]
+  membershipTierUids: [String!]
+}
+
+input PartnerAudienceSortInput {
+  field: PartnerAudienceSortField!
+  direction: SortDirection!
+}
+
+input GetPartnerAudienceInput {
+  filters: PartnerAudienceFiltersInput
+  sort: PartnerAudienceSortInput
+  cursor: String
+  take: Int
+  includeTotalCount: Boolean
+}
+
 # ─── Queries ─────────────────────────────────────────────────────────────────
 
 type BrandAgentEmailSendMessage {
@@ -1003,6 +1214,17 @@ type BrandAgentEmailSendBatch {
   messages: [BrandAgentEmailSendMessage!]!
 }
 
+type AgentThreadSeedContext {
+  """
+  Rendered prior-conversation transcript to seed a fresh agent session with,
+  or null when the thread has no renderable history.
+  """
+  seed: String
+  includedMessages: Int!
+  totalMessages: Int!
+  truncated: Boolean!
+}
+
 type Query {
   """
   Get details for the brand associated with the partner token.
@@ -1012,6 +1234,13 @@ type Query {
   """Retrieve one AgentMail send batch owned by the authenticated partner brand."""
   getPartnerAgentEmailBatch(batchUid: String!): BrandAgentEmailSendBatch!
 
+  """
+  Seed context for restoring a conversation thread into a fresh agent
+  session. Agent-access-token mode only: admin, brand, and thread scope all
+  derive from the verified token claims, so the operation takes no arguments.
+  """
+  getAgentThreadSeed: AgentThreadSeedContext!
+
   """
   Get paginated moments for the brand associated with the partner token.
   """
@@ -1081,6 +1310,12 @@ type Query {
     take: Int
   ): GetPartnerCustomersResponse!
 
+  """
+  Get the authenticated brand's customer audience using an allowlisted profile,
+  effective consent, and aggregate-metrics projection.
+  """
+  getPartnerAudience(input: GetPartnerAudienceInput): GetPartnerAudienceResponse!
+
   """
   Get a moment collection by slug.
   Returns the collection with its moments and links.
@@ -1158,6 +1393,8 @@ input SendPartnerAgentEmailInput {
   idempotencyKey: String!
   """One to ten personalized, single-recipient plain-text emails."""
   messages: [BrandAgentEmailMessageInput!]!
+  """Brand-agent session callers only; rejected for partner API keys"""
+  toolCallId: String
 }
 
 input VenueInput {
@@ -1224,6 +1461,10 @@ input CreatePartnerMomentInput {
   subcategory: MomentSubcategory
   """Ticket tiers to create along with the moment."""
   ticketTiers: [CreatePartnerTicketTierInput!]
+  """Brand-agent session callers only; rejected for partner API keys"""
+  idempotencyKey: String
+  """Brand-agent session callers only; rejected for partner API keys"""
+  toolCallId: String
 }
 
 input GetPartnerTicketTiersForMomentInput {
@@ -1382,6 +1623,13 @@ input PostSubscriptionMessageInput {
 
 input CreatePartnerBrandSubscriptionInput {
   compliance: SubscriptionComplianceInput
+
+  """
+  Exact opt-in disclosure the subscriber accepted, stored as consent evidence
+  alongside the subscription compliance record. Send the verbatim text shown on
+  your signup surface — it is the record of what the subscriber agreed to.
+  """
+  consentText: String
   email: String
 
   """Optional full name. If provided, include first and last name."""