@itm-studio/partner-sdk 0.2.0 → 0.2.2

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,44 @@ 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 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);
+}
+interface VerifyPartnerBrandSubscriptionInput {
+    code: Scalars['String'];
+    verificationToken: Scalars['String'];
+}
 /**
  * A presigned S3 upload URL and the generated filename.
  * Returned by getPartnerUploadUrl.
@@ -745,6 +842,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 +871,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 +889,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;
 }
@@ -834,6 +953,13 @@ declare const generateMutationOp: (fields: MutationGenqlSelection & {
     __name?: string;
 }) => GraphqlOperation;
 
+/**
+ * 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).
@@ -842,13 +968,15 @@ interface ITMPartnerClientConfig {
     token: string;
     /**
      * Base URL of the ITM GraphQL API.
-     * @default 'https://api.itm.studio/graphql'
+     * @default DEFAULT_API_URL
      */
     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;
 /**
@@ -881,4 +1009,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, 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 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,109 @@ 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
+      ]
+    },
+    "CreatePartnerBrandSubscriptionInput": {
+      "compliance": [
+        44
+      ],
+      "email": [
+        13
+      ],
+      "fullName": [
+        13
+      ],
+      "listNames": [
+        13
+      ],
+      "phoneNumber": [
+        13
+      ],
+      "requireOtpVerification": [
+        17
+      ],
+      "__typename": [
+        13
+      ]
+    },
+    "VerifyPartnerBrandSubscriptionInput": {
+      "code": [
+        13
+      ],
+      "verificationToken": [
+        13
       ],
       "__typename": [
         13
@@ -1401,7 +1549,7 @@ var types_default = {
         13
       ],
       "dimensions": [
-        30
+        31
       ],
       "size": [
         18
@@ -1422,9 +1570,23 @@ var types_default = {
         13
       ]
     },
+    "CreatePartnerBrandSubscriptionResponse": {
+      "subscription": [
+        38
+      ],
+      "verificationRequired": [
+        17
+      ],
+      "verificationToken": [
+        13
+      ],
+      "__typename": [
+        13
+      ]
+    },
     "Mutation": {
       "getPartnerUploadUrl": [
-        42,
+        47,
         {
           "filename": [
             13,
@@ -1437,7 +1599,7 @@ var types_default = {
         }
       ],
       "createPartnerMediaAsset": [
-        43,
+        48,
         {
           "mimetype": [
             13,
@@ -1448,20 +1610,38 @@ var types_default = {
             "String!"
           ],
           "dimensions": [
-            38,
+            40,
             "DimensionsInput!"
           ]
         }
       ],
+      "createPartnerBrandSubscription": [
+        49,
+        {
+          "input": [
+            45,
+            "CreatePartnerBrandSubscriptionInput!"
+          ]
+        }
+      ],
       "createPartnerMoment": [
         16,
         {
           "input": [
-            41,
+            43,
             "CreatePartnerMomentInput!"
           ]
         }
       ],
+      "verifyPartnerBrandSubscription": [
+        38,
+        {
+          "input": [
+            46,
+            "VerifyPartnerBrandSubscriptionInput!"
+          ]
+        }
+      ],
       "__typename": [
         13
       ]
@@ -1491,6 +1671,7 @@ var generateMutationOp = function(fields) {
 };
 
 // src/client.ts
+var DEFAULT_API_URL = "https://itm-backend-production.up.railway.app/graphql";
 function createITMPartnerClient(config) {
   const { token, baseUrl, headers: extraHeaders } = config;
   if (!token) {
@@ -1499,15 +1680,19 @@ function createITMPartnerClient(config) {
     );
   }
   return createClient2({
-    url: baseUrl ?? "https://api.itm.studio/graphql",
-    headers: {
-      "x-partner-api-key": token,
-      "Content-Type": "application/json",
-      ...extraHeaders
+    url: baseUrl ?? DEFAULT_API_URL,
+    headers: async () => {
+      const resolvedExtraHeaders = typeof extraHeaders === "function" ? await extraHeaders() : extraHeaders;
+      return {
+        ...resolvedExtraHeaders ?? {},
+        "x-partner-api-key": token,
+        "Content-Type": "application/json"
+      };
     }
   });
 }
 
+exports.DEFAULT_API_URL = DEFAULT_API_URL;
 exports.createITMPartnerClient = createITMPartnerClient;
 exports.everything = everything;
 exports.generateMutationOp = generateMutationOp;