@itm-studio/partner-sdk 0.1.1 → 0.1.2

package/README.md

@@ -66,10 +66,10 @@ Get paginated moments (events) for your brand.
 const { getPartnerMomentsForBrand } = await itm.query({
   getPartnerMomentsForBrand: {
     __args: {
-      take: 20,             // items per page (default: 50)
+      take: 20,             // items per page (default: 50, omit to use default)
       cursor: nextCursor,   // from previous response
       status: 'UPCOMING',   // UPCOMING | LIVE | ENDED
-      sortOrder: 'ASC',     // ASC | DESC (by start date)
+      sortOrder: 'ASC',     // ASC | DESC by start date (default: DESC)
     },
     moments: { uid: true, name: true, startDate: true },
     totalCount: true,
@@ -148,9 +148,65 @@ const { getPartnerCustomersForMoment } = await itm.query({
 });
 ```
 
+### `getPartnerMomentCollection`
+
+Get a moment collection by slug. Collections group related moments together (e.g. a summer series, a festival lineup). Returns the collection with its moments and links.
+
+```typescript
+const { getPartnerMomentCollection } = await itm.query({
+  getPartnerMomentCollection: {
+    __args: { slug: 'summer-series' },
+    uid: true,
+    name: true,
+    description: true,
+    subLabel: true,
+    availableQueryFilters: true,
+    moments: {
+      uid: true,
+      name: true,
+      slug: true,
+      startDate: true,
+      endDate: true,
+      status: true,
+      venue: { name: true, city: true },
+      ticketTiers: {
+        name: true,
+        price: true,
+        currency: { code: true, symbol: true },
+        remainingSupply: true,
+      },
+    },
+    links: {
+      uid: true,
+      url: true,
+      label: true,
+    },
+  },
+});
+```
+
+You can filter moments within a collection using `queryFilters`:
+
+```typescript
+const { getPartnerMomentCollection } = await itm.query({
+  getPartnerMomentCollection: {
+    __args: { slug: 'summer-series' },
+    name: true,
+    moments: {
+      __args: { queryFilters: ['upcoming'] },
+      uid: true,
+      name: true,
+      startDate: true,
+    },
+  },
+});
+```
+
+> **Note:** `getPartnerMomentCollection` returns `null` if no collection matches the given slug.
+
 ## Pagination
 
-All list endpoints use cursor-based pagination:
+All list endpoints use cursor-based pagination. The default page size is **50** items if `take` is not specified.
 
 ```typescript
 let cursor: string | null = null;

package/dist/index.d.mts

@@ -543,4 +543,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type Currency, type GetPartnerCustomersResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerClient, type ITMPartnerClientConfig, type MerchPurchase, type Moment, type MomentCategory, type MomentDiscountCodeUsage, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type PartnerCustomer, type Payment, type PaymentStatus, type Query, type Ticket, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, createITMPartnerClient, everything, generateQueryOp };
+export { type Currency, type GetPartnerCustomersResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerClient, type ITMPartnerClientConfig, type MerchPurchase, type Moment, type MomentCategory, type MomentCollection, type MomentCollectionLink, type MomentDiscountCodeUsage, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type PartnerCustomer, type Payment, type PaymentStatus, type Query, type Ticket, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, createITMPartnerClient, everything, generateQueryOp };

package/dist/index.d.ts

@@ -543,4 +543,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type Currency, type GetPartnerCustomersResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerClient, type ITMPartnerClientConfig, type MerchPurchase, type Moment, type MomentCategory, type MomentDiscountCodeUsage, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type PartnerCustomer, type Payment, type PaymentStatus, type Query, type Ticket, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, createITMPartnerClient, everything, generateQueryOp };
+export { type Currency, type GetPartnerCustomersResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerClient, type ITMPartnerClientConfig, type MerchPurchase, type Moment, type MomentCategory, type MomentCollection, type MomentCollectionLink, type MomentDiscountCodeUsage, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type PartnerCustomer, type Payment, type PaymentStatus, type Query, type Ticket, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, createITMPartnerClient, everything, generateQueryOp };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itm-studio/partner-sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "TypeScript SDK for the ITM Partner API — typed GraphQL client with zero introspection required",
   "main": "dist/index.js",
   "module": "dist/index.mjs",