@itm-studio/partner-sdk 0.2.1 → 0.2.3

package/dist/index.d.ts

@@ -162,6 +162,13 @@ interface PartnerCustomer {
     tickets: Ticket[];
     __typename: 'PartnerCustomer';
 }
+interface PartnerMomentStats {
+    ticketsCount: Scalars['Int'];
+    waitlistCount: Scalars['Int'];
+    externalRsvpCount: Scalars['Int'];
+    ticketRsvpRequestsCount: Scalars['Int'];
+    __typename: 'PartnerMomentStats';
+}
 interface MomentCollectionLink {
     uid: Scalars['ID'];
     url: Scalars['String'];
@@ -260,11 +267,24 @@ interface GetBrandEchoesForUserResponse {
     nextCursor: (Scalars['String'] | null);
     __typename: 'GetBrandEchoesForUserResponse';
 }
+interface BrandSubscription {
+    uid: Scalars['ID'];
+    isActive: Scalars['Boolean'];
+    subscribedAt: Scalars['DateTime'];
+    createdAt: Scalars['DateTime'];
+    updatedAt: Scalars['DateTime'];
+    __typename: 'BrandSubscription';
+}
 interface Query {
     /** Get paginated moments for the brand associated with the partner token. */
     getPartnerMomentsForBrand: GetPublicMomentsResponse;
     /** Get a single moment by slug. */
     getPartnerMoment: (Moment | null);
+    /**
+     * Get cached partner-facing counts for a moment.
+     * Only returns stats for moments owned by the authenticated partner's brand.
+     */
+    getPartnerMomentStats: (PartnerMomentStats | null);
     /** Get paginated tickets for a moment. */
     getPartnerTicketsForMoment: GetTicketsResponse;
     /**
@@ -315,6 +335,12 @@ interface MediaAsset {
     updatedAt: Scalars['DateTime'];
     __typename: 'MediaAsset';
 }
+interface CreatePartnerBrandSubscriptionResponse {
+    subscription: (BrandSubscription | null);
+    verificationRequired: Scalars['Boolean'];
+    verificationToken: (Scalars['String'] | null);
+    __typename: 'CreatePartnerBrandSubscriptionResponse';
+}
 interface Mutation {
     /**
      * Get a presigned S3 URL for direct file upload.
@@ -326,11 +352,18 @@ interface Mutation {
      * Call after uploading to S3 via the presigned URL from getPartnerUploadUrl.
      */
     createPartnerMediaAsset: MediaAsset;
+    /**
+     * Subscribe a user to the authenticated partner brand.
+     * Set requireOtpVerification to true to start a two-step OTP flow.
+     */
+    createPartnerBrandSubscription: CreatePartnerBrandSubscriptionResponse;
     /**
      * Create a moment with optional venue and ticket tiers in one atomic operation.
      * When type is IRL, the venue field is required.
      */
     createPartnerMoment: Moment;
+    /** Complete a partner brand subscription that was created with requireOtpVerification=true. */
+    verifyPartnerBrandSubscription: BrandSubscription;
     __typename: 'Mutation';
 }
 interface CurrencyGenqlSelection {
@@ -484,6 +517,14 @@ interface PartnerCustomerGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface PartnerMomentStatsGenqlSelection {
+    ticketsCount?: boolean | number;
+    waitlistCount?: boolean | number;
+    externalRsvpCount?: boolean | number;
+    ticketRsvpRequestsCount?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface MomentCollectionLinkGenqlSelection {
     uid?: boolean | number;
     url?: boolean | number;
@@ -595,6 +636,15 @@ interface GetBrandEchoesForUserResponseGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface BrandSubscriptionGenqlSelection {
+    uid?: boolean | number;
+    isActive?: boolean | number;
+    subscribedAt?: boolean | number;
+    createdAt?: boolean | number;
+    updatedAt?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface QueryGenqlSelection {
     /** Get paginated moments for the brand associated with the partner token. */
     getPartnerMomentsForBrand?: (GetPublicMomentsResponseGenqlSelection & {
@@ -613,6 +663,15 @@ interface QueryGenqlSelection {
             slug: Scalars['String'];
         };
     });
+    /**
+     * Get cached partner-facing counts for a moment.
+     * Only returns stats for moments owned by the authenticated partner's brand.
+     */
+    getPartnerMomentStats?: (PartnerMomentStatsGenqlSelection & {
+        __args: {
+            momentSlug: Scalars['String'];
+        };
+    });
     /** Get paginated tickets for a moment. */
     getPartnerTicketsForMoment?: (GetTicketsResponseGenqlSelection & {
         __args: {
@@ -713,6 +772,79 @@ interface CreatePartnerMomentInput {
     /** Ticket tiers to create along with the moment. */
     ticketTiers?: (CreatePartnerTicketTierInput[] | null);
 }
+interface SubscriptionComplianceInput {
+    browserName?: (Scalars['String'] | null);
+    browserVersion?: (Scalars['String'] | null);
+    deviceType?: (Scalars['String'] | null);
+    geoAccuracy?: (Scalars['Float'] | null);
+    geoCity?: (Scalars['String'] | null);
+    geoCountry?: (Scalars['String'] | null);
+    geoLatitude?: (Scalars['Float'] | null);
+    geoLongitude?: (Scalars['Float'] | null);
+    geoRegion?: (Scalars['String'] | null);
+    ipAddress?: (Scalars['String'] | null);
+    language?: (Scalars['String'] | null);
+    osName?: (Scalars['String'] | null);
+    osVersion?: (Scalars['String'] | null);
+    pageUrl?: (Scalars['String'] | null);
+    referrerUrl?: (Scalars['String'] | null);
+    screenHeight?: (Scalars['Int'] | null);
+    screenWidth?: (Scalars['Int'] | null);
+    submissionMethod?: (Scalars['String'] | null);
+    submittedAt?: (Scalars['DateTime'] | null);
+    timezone?: (Scalars['String'] | null);
+    userAgent?: (Scalars['String'] | null);
+}
+interface PostSubscriptionSmsInput {
+    /** SMS message body delivered to the subscriber. */
+    body: Scalars['String'];
+    /** Optional MMS media URLs (image links) attached to the SMS. */
+    mediaUrls?: (Scalars['String'][] | null);
+}
+interface PostSubscriptionEmailInput {
+    /** Email subject line. */
+    subject: Scalars['String'];
+    /** Plain-text or markdown body. Rendered via React Email. */
+    body: Scalars['String'];
+}
+interface PostSubscriptionPushInput {
+    /** Push notification title. */
+    title: Scalars['String'];
+    /** Push notification body. */
+    body: Scalars['String'];
+}
+/**
+ * Welcome message delivered after a successful subscription. Each channel is independent —
+ * provide any combination of sms, email, and push. Channels with no input are skipped.
+ * The message is sent at most once per active subscription period (atomic per-channel claim).
+ */
+interface PostSubscriptionMessageInput {
+    sms?: (PostSubscriptionSmsInput | null);
+    email?: (PostSubscriptionEmailInput | null);
+    push?: (PostSubscriptionPushInput | null);
+}
+interface CreatePartnerBrandSubscriptionInput {
+    compliance?: (SubscriptionComplianceInput | null);
+    email?: (Scalars['String'] | null);
+    /** Optional full name. If provided, include first and last name. */
+    fullName?: (Scalars['String'] | null);
+    /** Optional brand list names to attach the subscribed user to. Missing lists are created automatically. */
+    listNames?: (Scalars['String'][] | null);
+    /** E.164 phone number (for example +14155551234) */
+    phoneNumber: Scalars['String'];
+    requireOtpVerification?: (Scalars['Boolean'] | null);
+    /**
+     * Optional welcome message to deliver via the chosen channels. Sent at most once per active
+     * subscription period — safe to retry. Email requires the user to have a primary email and
+     * the brand to have a configured email alias. Push requires the user to have at least one
+     * push token and to not have opted out of brand messages.
+     */
+    postSubscriptionMessage?: (PostSubscriptionMessageInput | null);
+}
+interface VerifyPartnerBrandSubscriptionInput {
+    code: Scalars['String'];
+    verificationToken: Scalars['String'];
+}
 /**
  * A presigned S3 upload URL and the generated filename.
  * Returned by getPartnerUploadUrl.
@@ -745,6 +877,13 @@ interface MediaAssetGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface CreatePartnerBrandSubscriptionResponseGenqlSelection {
+    subscription?: BrandSubscriptionGenqlSelection;
+    verificationRequired?: boolean | number;
+    verificationToken?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface MutationGenqlSelection {
     /**
      * Get a presigned S3 URL for direct file upload.
@@ -767,6 +906,15 @@ interface MutationGenqlSelection {
             dimensions: DimensionsInput;
         };
     });
+    /**
+     * Subscribe a user to the authenticated partner brand.
+     * Set requireOtpVerification to true to start a two-step OTP flow.
+     */
+    createPartnerBrandSubscription?: (CreatePartnerBrandSubscriptionResponseGenqlSelection & {
+        __args: {
+            input: CreatePartnerBrandSubscriptionInput;
+        };
+    });
     /**
      * Create a moment with optional venue and ticket tiers in one atomic operation.
      * When type is IRL, the venue field is required.
@@ -776,6 +924,12 @@ interface MutationGenqlSelection {
             input: CreatePartnerMomentInput;
         };
     });
+    /** Complete a partner brand subscription that was created with requireOtpVerification=true. */
+    verifyPartnerBrandSubscription?: (BrandSubscriptionGenqlSelection & {
+        __args: {
+            input: VerifyPartnerBrandSubscriptionInput;
+        };
+    });
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
@@ -838,6 +992,9 @@ declare const generateMutationOp: (fields: MutationGenqlSelection & {
  * Default ITM backend production API endpoint.
  */
 declare const DEFAULT_API_URL = "https://itm-backend-production.up.railway.app/graphql";
+type MaybePromise<T> = T | Promise<T>;
+type ITMPartnerHeadersObject = Record<string, string>;
+type ITMPartnerHeaders = ITMPartnerHeadersObject | (() => MaybePromise<ITMPartnerHeadersObject | undefined>);
 interface ITMPartnerClientConfig {
     /**
      * Partner API token (from backstage: Settings > Partner API).
@@ -851,8 +1008,10 @@ interface ITMPartnerClientConfig {
     baseUrl?: string;
     /**
      * Additional headers to include on every request.
+     * A function is useful for request-scoped values like `x-forwarded-for`
+     * and `user-agent` when proxying end-user traffic through your server.
      */
-    headers?: Record<string, string>;
+    headers?: ITMPartnerHeaders;
 }
 type ITMPartnerClient = Client;
 /**
@@ -885,4 +1044,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, DEFAULT_API_URL, type Dimensions, type DimensionsInput, type Echo, type EchoMediaAsset, type EchoType, type GetBrandEchoesForUserResponse, type GetPartnerCustomersResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerClient, type ITMPartnerClientConfig, type MediaAsset, type MediaAssetUploadUrl, type MerchPurchase, type Moment, type MomentCategory, type MomentCollection, type MomentCollectionLink, type MomentDiscountCodeUsage, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type Mutation, type PartnerCustomer, type Payment, type PaymentStatus, type Query, type ThirdPartyEchoType, type Ticket, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, type VenueInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };
+export { type BrandSubscription, type CreatePartnerBrandSubscriptionInput, type CreatePartnerBrandSubscriptionResponse, type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, DEFAULT_API_URL, type Dimensions, type DimensionsInput, type Echo, type EchoMediaAsset, type EchoType, type GetBrandEchoesForUserResponse, type GetPartnerCustomersResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type MediaAsset, type MediaAssetUploadUrl, type MerchPurchase, type Moment, type MomentCategory, type MomentCollection, type MomentCollectionLink, type MomentDiscountCodeUsage, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type Mutation, type PartnerCustomer, type PartnerMomentStats, type Payment, type PaymentStatus, type PostSubscriptionEmailInput, type PostSubscriptionMessageInput, type PostSubscriptionPushInput, type PostSubscriptionSmsInput, type Query, type SubscriptionComplianceInput, type ThirdPartyEchoType, type Ticket, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };

package/dist/index.js

@@ -954,6 +954,23 @@ var types_default = {
         13
       ]
     },
+    "PartnerMomentStats": {
+      "ticketsCount": [
+        18
+      ],
+      "waitlistCount": [
+        18
+      ],
+      "externalRsvpCount": [
+        18
+      ],
+      "ticketRsvpRequestsCount": [
+        18
+      ],
+      "__typename": [
+        13
+      ]
+    },
     "MomentCollectionLink": {
       "uid": [
         12
@@ -1003,7 +1020,7 @@ var types_default = {
         }
       ],
       "links": [
-        28
+        29
       ],
       "createdAt": [
         0
@@ -1037,7 +1054,7 @@ var types_default = {
         13
       ],
       "dimensions": [
-        30
+        31
       ],
       "size": [
         18
@@ -1096,10 +1113,10 @@ var types_default = {
         1
       ],
       "mediaAsset": [
-        31
+        32
       ],
       "echoMedia": [
-        31
+        32
       ],
       "moment": [
         16
@@ -1167,7 +1184,7 @@ var types_default = {
     },
     "GetBrandEchoesForUserResponse": {
       "echoes": [
-        32
+        33
       ],
       "totalCount": [
         18
@@ -1182,9 +1199,29 @@ var types_default = {
         13
       ]
     },
+    "BrandSubscription": {
+      "uid": [
+        12
+      ],
+      "isActive": [
+        17
+      ],
+      "subscribedAt": [
+        0
+      ],
+      "createdAt": [
+        0
+      ],
+      "updatedAt": [
+        0
+      ],
+      "__typename": [
+        13
+      ]
+    },
     "Query": {
       "getPartnerMomentsForBrand": [
-        33,
+        34,
         {
           "cursor": [
             13
@@ -1209,8 +1246,17 @@ var types_default = {
           ]
         }
       ],
+      "getPartnerMomentStats": [
+        28,
+        {
+          "momentSlug": [
+            13,
+            "String!"
+          ]
+        }
+      ],
       "getPartnerTicketsForMoment": [
-        34,
+        35,
         {
           "momentSlug": [
             13,
@@ -1228,7 +1274,7 @@ var types_default = {
         }
       ],
       "getPartnerCustomersForMoment": [
-        35,
+        36,
         {
           "momentSlug": [
             13,
@@ -1243,7 +1289,7 @@ var types_default = {
         }
       ],
       "getPartnerMomentCollection": [
-        29,
+        30,
         {
           "slug": [
             13,
@@ -1252,7 +1298,7 @@ var types_default = {
         }
       ],
       "getPartnerPublicEchoes": [
-        36,
+        37,
         {
           "momentSlug": [
             13
@@ -1358,7 +1404,7 @@ var types_default = {
         13
       ],
       "venue": [
-        39
+        41
       ],
       "isPrivate": [
         17
@@ -1370,7 +1416,159 @@ var types_default = {
         6
       ],
       "ticketTiers": [
-        40
+        42
+      ],
+      "__typename": [
+        13
+      ]
+    },
+    "SubscriptionComplianceInput": {
+      "browserName": [
+        13
+      ],
+      "browserVersion": [
+        13
+      ],
+      "deviceType": [
+        13
+      ],
+      "geoAccuracy": [
+        20
+      ],
+      "geoCity": [
+        13
+      ],
+      "geoCountry": [
+        13
+      ],
+      "geoLatitude": [
+        20
+      ],
+      "geoLongitude": [
+        20
+      ],
+      "geoRegion": [
+        13
+      ],
+      "ipAddress": [
+        13
+      ],
+      "language": [
+        13
+      ],
+      "osName": [
+        13
+      ],
+      "osVersion": [
+        13
+      ],
+      "pageUrl": [
+        13
+      ],
+      "referrerUrl": [
+        13
+      ],
+      "screenHeight": [
+        18
+      ],
+      "screenWidth": [
+        18
+      ],
+      "submissionMethod": [
+        13
+      ],
+      "submittedAt": [
+        0
+      ],
+      "timezone": [
+        13
+      ],
+      "userAgent": [
+        13
+      ],
+      "__typename": [
+        13
+      ]
+    },
+    "PostSubscriptionSmsInput": {
+      "body": [
+        13
+      ],
+      "mediaUrls": [
+        13
+      ],
+      "__typename": [
+        13
+      ]
+    },
+    "PostSubscriptionEmailInput": {
+      "subject": [
+        13
+      ],
+      "body": [
+        13
+      ],
+      "__typename": [
+        13
+      ]
+    },
+    "PostSubscriptionPushInput": {
+      "title": [
+        13
+      ],
+      "body": [
+        13
+      ],
+      "__typename": [
+        13
+      ]
+    },
+    "PostSubscriptionMessageInput": {
+      "sms": [
+        45
+      ],
+      "email": [
+        46
+      ],
+      "push": [
+        47
+      ],
+      "__typename": [
+        13
+      ]
+    },
+    "CreatePartnerBrandSubscriptionInput": {
+      "compliance": [
+        44
+      ],
+      "email": [
+        13
+      ],
+      "fullName": [
+        13
+      ],
+      "listNames": [
+        13
+      ],
+      "phoneNumber": [
+        13
+      ],
+      "requireOtpVerification": [
+        17
+      ],
+      "postSubscriptionMessage": [
+        48
+      ],
+      "__typename": [
+        13
+      ]
+    },
+    "VerifyPartnerBrandSubscriptionInput": {
+      "code": [
+        13
+      ],
+      "verificationToken": [
+        13
       ],
       "__typename": [
         13
@@ -1401,7 +1599,7 @@ var types_default = {
         13
       ],
       "dimensions": [
-        30
+        31
       ],
       "size": [
         18
@@ -1422,9 +1620,23 @@ var types_default = {
         13
       ]
     },
+    "CreatePartnerBrandSubscriptionResponse": {
+      "subscription": [
+        38
+      ],
+      "verificationRequired": [
+        17
+      ],
+      "verificationToken": [
+        13
+      ],
+      "__typename": [
+        13
+      ]
+    },
     "Mutation": {
       "getPartnerUploadUrl": [
-        42,
+        51,
         {
           "filename": [
             13,
@@ -1437,7 +1649,7 @@ var types_default = {
         }
       ],
       "createPartnerMediaAsset": [
-        43,
+        52,
         {
           "mimetype": [
             13,
@@ -1448,20 +1660,38 @@ var types_default = {
             "String!"
           ],
           "dimensions": [
-            38,
+            40,
             "DimensionsInput!"
           ]
         }
       ],
+      "createPartnerBrandSubscription": [
+        53,
+        {
+          "input": [
+            49,
+            "CreatePartnerBrandSubscriptionInput!"
+          ]
+        }
+      ],
       "createPartnerMoment": [
         16,
         {
           "input": [
-            41,
+            43,
             "CreatePartnerMomentInput!"
           ]
         }
       ],
+      "verifyPartnerBrandSubscription": [
+        38,
+        {
+          "input": [
+            50,
+            "VerifyPartnerBrandSubscriptionInput!"
+          ]
+        }
+      ],
       "__typename": [
         13
       ]
@@ -1501,10 +1731,13 @@ function createITMPartnerClient(config) {
   }
   return createClient2({
     url: baseUrl ?? DEFAULT_API_URL,
-    headers: {
-      "x-partner-api-key": token,
-      "Content-Type": "application/json",
-      ...extraHeaders
+    headers: async () => {
+      const resolvedExtraHeaders = typeof extraHeaders === "function" ? await extraHeaders() : extraHeaders;
+      return {
+        ...resolvedExtraHeaders ?? {},
+        "x-partner-api-key": token,
+        "Content-Type": "application/json"
+      };
     }
   });
 }