@itm-studio/partner-sdk 0.2.8 → 0.2.9

package/README.md

@@ -67,6 +67,19 @@ The token is sent as the `x-partner-api-key` header on every request. Your brand
 
 Keep the partner token on your server. Do not expose it from browser code or client-side mobile code.
 
+The SDK enforces this boundary and supports Node.js server runtimes only. Imports
+from browsers, React Native, Web or Service Workers, edge runtimes, and Electron
+processes fail before an authenticated client can be created. Send client-side
+requests to your own Node backend, then return only the data the client needs.
+
+In Next.js, also mark the module that reads the token as server-only so an
+accidental Client Component import fails during the application build:
+
+```typescript
+import "server-only";
+import { createITMPartnerClient } from "@itm-studio/partner-sdk";
+```
+
 For request-scoped mutations such as partner brand subscriptions, create the client inside the incoming request and forward `x-forwarded-for` and `user-agent` so the backend can enrich compliance metadata when those fields are omitted from `input.compliance`.
 
 ```typescript
@@ -264,6 +277,7 @@ const { getPartnerMomentsForBrand } = await itm.query({
       take: 20, // items per page (default: 50, omit to use default)
       cursor: nextCursor, // from previous response
       status: "UPCOMING", // UPCOMING | LIVE | ENDED
+      filters: { includePrivate: true }, // include private moments owned by your brand
       sortOrder: "ASC", // ASC | DESC by start date (default: DESC)
     },
     moments: { uid: true, name: true, startDate: true },
@@ -274,6 +288,11 @@ const { getPartnerMomentsForBrand } = await itm.query({
 });
 ```
 
+By default, only public moments are returned. Set
+`filters.includePrivate` to `true` to return both public and private moments
+owned by the brand associated with the partner token. Omitting `filters`, or
+setting `includePrivate` to `false`, preserves the public-only behavior.
+
 ### `getPartnerDrops`
 
 Get paginated brand drops for the brand associated with your partner token.

package/dist/index.d.mts

@@ -1302,6 +1302,10 @@ interface MomentLineupResponseResultGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface PartnerMomentsFiltersInput {
+    /** When true, includes private moments owned by the authenticated brand. Default: false. */
+    includePrivate?: (Scalars['Boolean'] | null);
+}
 interface QueryGenqlSelection {
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand?: PartnerBrandGenqlSelection;
@@ -1312,6 +1316,7 @@ interface QueryGenqlSelection {
             cursor?: (Scalars['String'] | null);
             take?: (Scalars['Int'] | null);
             status?: (MomentStatus | null);
+            filters?: (PartnerMomentsFiltersInput | null);
             /** Sort order for moments by start date (default: DESC - newest to oldest) */
             sortOrder?: (MomentSortOrder | null);
         };
@@ -1893,4 +1898,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type ApplyDynamicPricingInput, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type CreateMomentOnlineConfigInput, type CreatePartnerBrandSubscriptionInput, type CreatePartnerBrandSubscriptionResponse, type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, DEFAULT_API_URL, type Dimensions, type DimensionsInput, type DynamicPricingActorType, type DynamicPricingAdmissionWindow, type DynamicPricingBatch, type DynamicPricingBatchEvent, type DynamicPricingBatchEventType, type DynamicPricingBatchItem, type DynamicPricingBatchItemStatus, type DynamicPricingBatchStatus, type DynamicPricingContext, type DynamicPricingExecutionMode, type DynamicPricingInventoryGuardInput, type DynamicPricingInventoryGuardMode, type DynamicPricingInventoryMetric, type DynamicPricingMomentInput, type DynamicPricingTierContext, type DynamicPricingTierUpdateInput, type Echo, type EchoMediaAsset, type EchoType, type EditPartnerTicketTiersForMomentInput, type EventImportPlatform, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, 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 MomentDynamicPricingPolicy, type MomentDynamicPricingTierRule, type MomentLineup, type MomentLineupDisplayLabel, type MomentLineupResponseResult, type MomentLineupStatus, type MomentLineupType, type MomentOnlineProvider, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type MusicReleaseType, type Mutation, type PartnerBrand, type PartnerCustomer, type PartnerMomentAttendanceCount, type PartnerMomentAttendanceLookupInput, type PartnerMomentAttendanceStats, type PartnerMomentGuestlistAttendance, type PartnerMomentGuestlistLabelAttendance, type PartnerMomentStats, type PartnerMomentTicketAttendance, type PartnerMomentTicketTierAttendance, type PartnerTicketTier, type PartnerTicketTierUpdateInput, type Payment, type PaymentStatus, type PostSubscriptionEmailInput, type PostSubscriptionMessageInput, type PostSubscriptionPushInput, type PostSubscriptionSmsInput, type PublicMomentLineupInfo, type Query, type RespondToMomentLineupInput, type SubscriptionComplianceInput, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };
+export { type ApplyDynamicPricingInput, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type CreateMomentOnlineConfigInput, type CreatePartnerBrandSubscriptionInput, type CreatePartnerBrandSubscriptionResponse, type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, DEFAULT_API_URL, type Dimensions, type DimensionsInput, type DynamicPricingActorType, type DynamicPricingAdmissionWindow, type DynamicPricingBatch, type DynamicPricingBatchEvent, type DynamicPricingBatchEventType, type DynamicPricingBatchItem, type DynamicPricingBatchItemStatus, type DynamicPricingBatchStatus, type DynamicPricingContext, type DynamicPricingExecutionMode, type DynamicPricingInventoryGuardInput, type DynamicPricingInventoryGuardMode, type DynamicPricingInventoryMetric, type DynamicPricingMomentInput, type DynamicPricingTierContext, type DynamicPricingTierUpdateInput, type Echo, type EchoMediaAsset, type EchoType, type EditPartnerTicketTiersForMomentInput, type EventImportPlatform, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, 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 MomentDynamicPricingPolicy, type MomentDynamicPricingTierRule, type MomentLineup, type MomentLineupDisplayLabel, type MomentLineupResponseResult, type MomentLineupStatus, type MomentLineupType, type MomentOnlineProvider, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type MusicReleaseType, type Mutation, type PartnerBrand, type PartnerCustomer, type PartnerMomentAttendanceCount, type PartnerMomentAttendanceLookupInput, type PartnerMomentAttendanceStats, type PartnerMomentGuestlistAttendance, type PartnerMomentGuestlistLabelAttendance, type PartnerMomentStats, type PartnerMomentTicketAttendance, type PartnerMomentTicketTierAttendance, type PartnerMomentsFiltersInput, type PartnerTicketTier, type PartnerTicketTierUpdateInput, type Payment, type PaymentStatus, type PostSubscriptionEmailInput, type PostSubscriptionMessageInput, type PostSubscriptionPushInput, type PostSubscriptionSmsInput, type PublicMomentLineupInfo, type Query, type RespondToMomentLineupInput, type SubscriptionComplianceInput, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };

package/dist/index.d.ts

@@ -1302,6 +1302,10 @@ interface MomentLineupResponseResultGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface PartnerMomentsFiltersInput {
+    /** When true, includes private moments owned by the authenticated brand. Default: false. */
+    includePrivate?: (Scalars['Boolean'] | null);
+}
 interface QueryGenqlSelection {
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand?: PartnerBrandGenqlSelection;
@@ -1312,6 +1316,7 @@ interface QueryGenqlSelection {
             cursor?: (Scalars['String'] | null);
             take?: (Scalars['Int'] | null);
             status?: (MomentStatus | null);
+            filters?: (PartnerMomentsFiltersInput | null);
             /** Sort order for moments by start date (default: DESC - newest to oldest) */
             sortOrder?: (MomentSortOrder | null);
         };
@@ -1893,4 +1898,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type ApplyDynamicPricingInput, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type CreateMomentOnlineConfigInput, type CreatePartnerBrandSubscriptionInput, type CreatePartnerBrandSubscriptionResponse, type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, DEFAULT_API_URL, type Dimensions, type DimensionsInput, type DynamicPricingActorType, type DynamicPricingAdmissionWindow, type DynamicPricingBatch, type DynamicPricingBatchEvent, type DynamicPricingBatchEventType, type DynamicPricingBatchItem, type DynamicPricingBatchItemStatus, type DynamicPricingBatchStatus, type DynamicPricingContext, type DynamicPricingExecutionMode, type DynamicPricingInventoryGuardInput, type DynamicPricingInventoryGuardMode, type DynamicPricingInventoryMetric, type DynamicPricingMomentInput, type DynamicPricingTierContext, type DynamicPricingTierUpdateInput, type Echo, type EchoMediaAsset, type EchoType, type EditPartnerTicketTiersForMomentInput, type EventImportPlatform, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, 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 MomentDynamicPricingPolicy, type MomentDynamicPricingTierRule, type MomentLineup, type MomentLineupDisplayLabel, type MomentLineupResponseResult, type MomentLineupStatus, type MomentLineupType, type MomentOnlineProvider, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type MusicReleaseType, type Mutation, type PartnerBrand, type PartnerCustomer, type PartnerMomentAttendanceCount, type PartnerMomentAttendanceLookupInput, type PartnerMomentAttendanceStats, type PartnerMomentGuestlistAttendance, type PartnerMomentGuestlistLabelAttendance, type PartnerMomentStats, type PartnerMomentTicketAttendance, type PartnerMomentTicketTierAttendance, type PartnerTicketTier, type PartnerTicketTierUpdateInput, type Payment, type PaymentStatus, type PostSubscriptionEmailInput, type PostSubscriptionMessageInput, type PostSubscriptionPushInput, type PostSubscriptionSmsInput, type PublicMomentLineupInfo, type Query, type RespondToMomentLineupInput, type SubscriptionComplianceInput, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };
+export { type ApplyDynamicPricingInput, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type CreateMomentOnlineConfigInput, type CreatePartnerBrandSubscriptionInput, type CreatePartnerBrandSubscriptionResponse, type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, DEFAULT_API_URL, type Dimensions, type DimensionsInput, type DynamicPricingActorType, type DynamicPricingAdmissionWindow, type DynamicPricingBatch, type DynamicPricingBatchEvent, type DynamicPricingBatchEventType, type DynamicPricingBatchItem, type DynamicPricingBatchItemStatus, type DynamicPricingBatchStatus, type DynamicPricingContext, type DynamicPricingExecutionMode, type DynamicPricingInventoryGuardInput, type DynamicPricingInventoryGuardMode, type DynamicPricingInventoryMetric, type DynamicPricingMomentInput, type DynamicPricingTierContext, type DynamicPricingTierUpdateInput, type Echo, type EchoMediaAsset, type EchoType, type EditPartnerTicketTiersForMomentInput, type EventImportPlatform, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, 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 MomentDynamicPricingPolicy, type MomentDynamicPricingTierRule, type MomentLineup, type MomentLineupDisplayLabel, type MomentLineupResponseResult, type MomentLineupStatus, type MomentLineupType, type MomentOnlineProvider, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type MusicReleaseType, type Mutation, type PartnerBrand, type PartnerCustomer, type PartnerMomentAttendanceCount, type PartnerMomentAttendanceLookupInput, type PartnerMomentAttendanceStats, type PartnerMomentGuestlistAttendance, type PartnerMomentGuestlistLabelAttendance, type PartnerMomentStats, type PartnerMomentTicketAttendance, type PartnerMomentTicketTierAttendance, type PartnerMomentsFiltersInput, type PartnerTicketTier, type PartnerTicketTierUpdateInput, type Payment, type PaymentStatus, type PostSubscriptionEmailInput, type PostSubscriptionMessageInput, type PostSubscriptionPushInput, type PostSubscriptionSmsInput, type PublicMomentLineupInfo, type Query, type RespondToMomentLineupInput, type SubscriptionComplianceInput, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };

package/dist/index.js

@@ -1388,10 +1388,10 @@ var types_default = {
         20
       ],
       "coverImage": [
-        102
+        103
       ],
       "coverImageMobile": [
-        102
+        103
       ],
       "isActive": [
         25
@@ -1988,6 +1988,14 @@ var types_default = {
         20
       ]
     },
+    "PartnerMomentsFiltersInput": {
+      "includePrivate": [
+        25
+      ],
+      "__typename": [
+        20
+      ]
+    },
     "Query": {
       "getPartnerBrand": [
         21
@@ -2004,6 +2012,9 @@ var types_default = {
           "status": [
             2
           ],
+          "filters": [
+            80
+          ],
           "sortOrder": [
             3
           ]
@@ -2116,7 +2127,7 @@ var types_default = {
         60,
         {
           "input": [
-            86,
+            87,
             "GetPartnerTicketTiersForMomentInput!"
           ]
         }
@@ -2125,7 +2136,7 @@ var types_default = {
         73,
         {
           "input": [
-            89,
+            90,
             "DynamicPricingMomentInput!"
           ]
         }
@@ -2282,10 +2293,10 @@ var types_default = {
         20
       ],
       "venue": [
-        82
+        83
       ],
       "onlineConfig": [
-        84
+        85
       ],
       "isPrivate": [
         25
@@ -2300,7 +2311,7 @@ var types_default = {
         10
       ],
       "ticketTiers": [
-        83
+        84
       ],
       "__typename": [
         20
@@ -2408,7 +2419,7 @@ var types_default = {
         20
       ],
       "updates": [
-        87
+        88
       ],
       "__typename": [
         20
@@ -2439,7 +2450,7 @@ var types_default = {
         20
       ],
       "inventoryGuard": [
-        91
+        92
       ],
       "externalSignals": [
         1
@@ -2497,7 +2508,7 @@ var types_default = {
         1
       ],
       "updates": [
-        90
+        91
       ],
       "__typename": [
         20
@@ -2617,13 +2628,13 @@ var types_default = {
     },
     "PostSubscriptionMessageInput": {
       "sms": [
-        95
+        96
       ],
       "email": [
-        96
+        97
       ],
       "push": [
-        97
+        98
       ],
       "__typename": [
         20
@@ -2631,7 +2642,7 @@ var types_default = {
     },
     "CreatePartnerBrandSubscriptionInput": {
       "compliance": [
-        94
+        95
       ],
       "email": [
         20
@@ -2649,7 +2660,7 @@ var types_default = {
         25
       ],
       "postSubscriptionMessage": [
-        98
+        99
       ],
       "__typename": [
         20
@@ -2728,7 +2739,7 @@ var types_default = {
     },
     "Mutation": {
       "getPartnerUploadUrl": [
-        101,
+        102,
         {
           "filename": [
             20,
@@ -2741,7 +2752,7 @@ var types_default = {
         }
       ],
       "createPartnerMediaAsset": [
-        102,
+        103,
         {
           "mimetype": [
             20,
@@ -2752,16 +2763,16 @@ var types_default = {
             "String!"
           ],
           "dimensions": [
-            81,
+            82,
             "DimensionsInput!"
           ]
         }
       ],
       "createPartnerBrandSubscription": [
-        103,
+        104,
         {
           "input": [
-            99,
+            100,
             "CreatePartnerBrandSubscriptionInput!"
           ]
         }
@@ -2770,7 +2781,7 @@ var types_default = {
         24,
         {
           "input": [
-            85,
+            86,
             "CreatePartnerMomentInput!"
           ]
         }
@@ -2779,7 +2790,7 @@ var types_default = {
         59,
         {
           "input": [
-            88,
+            89,
             "EditPartnerTicketTiersForMomentInput!"
           ]
         }
@@ -2788,7 +2799,7 @@ var types_default = {
         76,
         {
           "input": [
-            92,
+            93,
             "ApplyDynamicPricingInput!"
           ]
         }
@@ -2797,7 +2808,7 @@ var types_default = {
         77,
         {
           "input": [
-            100,
+            101,
             "VerifyPartnerBrandSubscriptionInput!"
           ]
         }
@@ -2806,7 +2817,7 @@ var types_default = {
         79,
         {
           "input": [
-            93,
+            94,
             "RespondToMomentLineupInput!"
           ]
         }
@@ -2839,7 +2850,21 @@ var generateMutationOp = function(fields) {
   return generateGraphqlOperation("mutation", typeMap.Mutation, fields);
 };
 
+// src/runtime.ts
+var NODE_SERVER_ONLY_ERROR = "ITM Partner SDK is Node-server-only. Do not import it in browser, React Native, worker, edge, or Electron process code. Call it from a Node backend and return only the data the client needs.";
+function assertNodeServerRuntime(runtime = globalThis) {
+  const runtimeProcess = runtime.process;
+  const isNode = runtimeProcess?.release?.name === "node" && typeof runtimeProcess.versions?.node === "string";
+  const isBrowserWindow = typeof runtime.window !== "undefined";
+  const isReactNative = runtime.navigator?.product === "ReactNative";
+  const isElectron = typeof runtimeProcess?.versions?.electron === "string" || typeof runtimeProcess?.type === "string";
+  if (!isNode || isBrowserWindow || isReactNative || isElectron) {
+    throw new Error(NODE_SERVER_ONLY_ERROR);
+  }
+}
+
 // src/client.ts
+assertNodeServerRuntime();
 var DEFAULT_API_URL = "https://itm-backend-production.up.railway.app/graphql";
 function createITMPartnerClient(config) {
   const { token, baseUrl, headers: extraHeaders } = config;