@itm-studio/partner-sdk 0.2.9 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itm-studio/partner-sdk",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "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,6 +9,49 @@ scalar JSON
 
 # ─── Enums ───────────────────────────────────────────────────────────────────
 
+enum ConsentStatus {
+  NEVER_SUBSCRIBED
+  SUBSCRIBED
+  UNSUBSCRIBED
+}
+
+enum UserSource {
+  BRAND
+  DICE
+  ITM
+}
+
+enum SortDirection {
+  ASC
+  DESC
+}
+
+enum BrandAgentEmailSendBatchStatus {
+  PENDING
+  SENDING
+  SENT
+  PARTIAL
+  FAILED
+  UNKNOWN
+}
+
+enum BrandAgentEmailSendMessageStatus {
+  PENDING
+  SENDING
+  SENT
+  FAILED
+  UNKNOWN
+}
+
+enum PartnerAudienceSortField {
+  CITY
+  CREATED_AT
+  NAME
+  NUM_MOMENTS
+  TOTAL_SPEND_USD
+  UPDATED_AT
+}
+
 enum MomentStatus {
   UPCOMING
   LIVE
@@ -497,8 +540,35 @@ 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!
+  """Confirmed tickets whose materialized price is greater than zero."""
+  paidTicketsCount: Int!
+  """Confirmed tickets whose materialized price is zero."""
+  freeTicketsCount: Int!
   waitlistCount: Int!
   externalRsvpCount: Int!
   ticketRsvpRequestsCount: Int!
@@ -718,6 +788,13 @@ type GetPartnerCustomersResponse {
   nextCursor: String
 }
 
+type GetPartnerAudienceResponse {
+  customers: [PartnerAudienceCustomer!]!
+  hasNextPage: Boolean!
+  nextCursor: String
+  totalCount: Int
+}
+
 type GetBrandEchoesForUserResponse {
   echoes: [Echo!]!
   totalCount: Int!
@@ -944,20 +1021,110 @@ type MomentLineupResponseResult {
 }
 
 input PartnerMomentsFiltersInput {
+  """
+  Case-insensitive search over moment name and slug. Whitespace-only values are ignored.
+  """
+  search: String
+
   """
   When true, includes private moments owned by the authenticated brand. Default: false.
   """
   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 {
+  uid: String!
+  position: Int!
+  recipient: String!
+  subject: String!
+  text: String!
+  status: BrandAgentEmailSendMessageStatus!
+  agentMailMessageId: String
+  agentMailThreadId: String
+  sentAt: DateTime
+  failedAt: DateTime
+  lastErrorCode: String
+  lastErrorMessage: String
+}
+
+type BrandAgentEmailSendBatch {
+  uid: String!
+  createdAt: DateTime!
+  status: BrandAgentEmailSendBatchStatus!
+  senderEmailAddress: String!
+  acceptedCount: Int!
+  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.
   """
   getPartnerBrand: PartnerBrand!
 
+  """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.
   """
@@ -1027,6 +1194,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.
@@ -1092,6 +1265,22 @@ input DimensionsInput {
   height: Float!
 }
 
+input BrandAgentEmailMessageInput {
+  """One normalized recipient. Each item is sent as a separate email."""
+  to: String!
+  subject: String!
+  text: String!
+}
+
+input SendPartnerAgentEmailInput {
+  """Stable business idempotency key for this logical batch."""
+  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 {
   name: String!
   city: String!
@@ -1156,6 +1345,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 {
@@ -1413,6 +1606,11 @@ type Mutation {
   """
   createPartnerMoment(input: CreatePartnerMomentInput!): Moment!
 
+  """Queue one to ten emails from the authenticated brand's AgentMail inbox."""
+  sendPartnerAgentEmail(
+    input: SendPartnerAgentEmailInput!
+  ): BrandAgentEmailSendBatch!
+
   """
   Bulk edit partner-owned ticket tiers for a moment.
   Supports per-tier price, facility-fee, and supply updates.