@itm-studio/partner-sdk 0.2.10 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itm-studio/partner-sdk",
-  "version": "0.2.10",
+  "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,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
@@ -514,6 +540,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 +788,13 @@ type GetPartnerCustomersResponse {
   nextCursor: String
 }
 
+type GetPartnerAudienceResponse {
+  customers: [PartnerAudienceCustomer!]!
+  hasNextPage: Boolean!
+  nextCursor: String
+  totalCount: Int
+}
+
 type GetBrandEchoesForUserResponse {
   echoes: [Echo!]!
   totalCount: Int!
@@ -977,6 +1032,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 +1098,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 +1118,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 +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.
@@ -1158,6 +1277,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 +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 {