@itm-studio/partner-sdk 0.3.0 → 0.3.2

package/README.md

@@ -32,6 +32,8 @@ const { getPartnerMomentsForBrand } = await itm.query({
       slug: true,
       startDate: true,
       endDate: true,
+      category: true,
+      subcategory: true,
       status: true,
       timezone: true,
       externalUrl: true,
@@ -394,7 +396,13 @@ const { getPartnerMomentsForBrand } = await itm.query({
       },
       sortOrder: "ASC", // ASC | DESC by start date (default: DESC)
     },
-    moments: { uid: true, name: true, startDate: true },
+    moments: {
+      uid: true,
+      name: true,
+      startDate: true,
+      category: true,
+      subcategory: true,
+    },
     totalCount: true,
     hasNextPage: true,
     nextCursor: true,
@@ -409,6 +417,49 @@ setting `includePrivate` to `false`, preserves the public-only behavior.
 `filters.search` matches moment names and slugs case-insensitively, is limited
 to 100 characters, and composes with visibility, status, sorting, and cursor
 pagination.
+Select `category` and `subcategory` on each moment when you need to filter or
+group SDK results by the event taxonomy. Both values are set when the moment
+is created; a film screening created with `category: "SCREENING"` and
+`subcategory: "FILM_SCREENING"` is returned with exactly those values.
+
+Moment tags can provide campaign-specific grouping without changing the event
+taxonomy. `momentTags` is available on every `Moment` the SDK returns, including
+`getPartnerMoment`. Only tags marked partner-visible are returned; private tags
+are never available through the SDK. Each assignment includes whether it was
+added manually or automatically. `pagination.take` must be a positive integer;
+it defaults to 50 and is capped at 100. Pass `nextCursor` back as
+`pagination.cursor` to fetch the next page:
+
+```typescript
+const { getPartnerMomentsForBrand } = await itm.query({
+  getPartnerMomentsForBrand: {
+    __args: { take: 20 },
+    moments: {
+      uid: true,
+      name: true,
+      momentTags: {
+        __args: {
+          sources: ["MANUAL"], // omit to include MANUAL and AUTO
+          pagination: { take: 50 },
+        },
+        assignments: {
+          tag: { uid: true, name: true },
+          source: true,
+          isPublic: true,
+          confidence: true,
+        },
+        totalCount: true,
+        hasNextPage: true,
+        nextCursor: true,
+      },
+    },
+    totalCount: true,
+  },
+});
+```
+
+Use the returned Moment UIDs with audience filters when you need users who
+interacted with Moments from a particular film campaign.
 
 ### `getPartnerDrops`
 
@@ -483,6 +534,11 @@ const { getPartnerMoment } = await itm.query({
       url: true,
       mimeType: true,
     },
+    venue: {
+      name: true,
+      city: true,
+      postalCode: true,
+    },
     ticketTiers: {
       name: true,
       price: true,
@@ -971,8 +1027,43 @@ Use OTP subscribe when you want the user to confirm the phone number before the
 - `listNames`: optional brand list names. Missing lists are created automatically and the subscribed user is attached to them.
 - `compliance`: optional metadata about how consent was collected. This is the right place for fields like `pageUrl`, `submissionMethod`, `submittedAt`, `timezone`, and geo/browser/device details.
 - `compliance.ipAddress` and `compliance.userAgent`: optional. If you omit them and forward `x-forwarded-for` and `user-agent`, the backend backfills those values for you.
+- `consentText`: optional but strongly recommended. Send the verbatim opt-in disclosure the subscriber accepted on your signup surface, up to 5000 characters. See [Marketing Consent](#marketing-consent).
 - `postSubscriptionMessage`: optional welcome message delivered automatically after the subscription becomes active. The SDK exposes this as `PostSubscriptionMessageInput` and accepts it on `CreatePartnerBrandSubscriptionInput`. See [Post-Subscription Welcome Message](#post-subscription-welcome-message).
 
+### Marketing Consent
+
+A successful subscription **is** the marketing opt-in. Once `createPartnerBrandSubscription` (or `verifyPartnerBrandSubscription` for OTP flows) returns, the subscriber is consented for the brand's marketing SMS, and for email once an address is on file. Consent flows through to the brand's connected email/SMS destinations automatically.
+
+Existing opt-outs always win, per channel. A prior STOP keyword or SMS unsubscribe for that brand blocks the SMS consent grant, and a prior email unsubscribe blocks the email consent grant — the subscription still succeeds, but consent is not granted on an opted-out channel. Users the brand has blacklisted cannot subscribe at all: the mutation fails with an authorization error.
+
+**Because the subscribe call grants consent, collect the opt-in properly on your surface:**
+
+- Show an explicit marketing consent disclosure at signup.
+- Send that exact disclosure back as `consentText`. It is stored with the subscription's compliance record as evidence of what the subscriber agreed to.
+- Send `compliance` metadata (at minimum `pageUrl` and `submissionMethod`) alongside it, and forward `x-forwarded-for` and `user-agent` so IP and user agent are captured.
+
+```typescript
+await client.mutation({
+  createPartnerBrandSubscription: {
+    __args: {
+      input: {
+        phoneNumber: "+14155551234",
+        consentText:
+          "By joining, you agree to receive recurring marketing texts from Brand. Msg & data rates may apply. Reply STOP to opt out.",
+        compliance: {
+          pageUrl: "https://example.com/signup",
+          submissionMethod: "partner_sdk",
+        },
+      },
+    },
+    subscription: { uid: true },
+    verificationRequired: true,
+  },
+});
+```
+
+`consentText` is trimmed before it is stored, and a blank value is treated as omitted. Values longer than 5000 characters are rejected with a validation error, not truncated. In OTP mode the text is captured on the first call and re-used automatically when the flow is verified — send it on the first call only.
+
 ### OTP Flow Step By Step
 
 1. Call `createPartnerBrandSubscription` with `requireOtpVerification: true`.
@@ -1738,3 +1829,53 @@ When exposing a new backend endpoint to partners:
 3. Add tests in `tests/queries.test.ts`
 4. Open a PR — Hive will validate the schema change isn't breaking
 5. After merge, the schema is auto-published to Hive and a new SDK version can be released
+
+### Browse brand media (partners and agents)
+
+`getPartnerMediaAssets` returns active assets linked to the authenticated brand,
+newest first. It defaults to 50 assets per page and caps `take` at 100. Follow
+`nextCursor` while `hasNextPage` is true; `totalCount` counts the matching library,
+not just this page. `mimeTypePrefix` is case-insensitive (`image/`, `video/`,
+`application/pdf`, etc.). Existing upload paths without a brand association are
+not included; an empty result does not prove the brand never uploaded a file.
+
+```ts
+const { getPartnerMediaAssets: page } = await client.query({
+  getPartnerMediaAssets: {
+    __args: { input: { take: 20, mimeTypePrefix: 'image/' } },
+    mediaAssets: {
+      uid: true, url: true, mimeType: true,
+      dimensions: { width: true, height: true },
+      transforms: { original: true, small: true, hls: true },
+      createdAt: true,
+    },
+    totalCount: true, hasNextPage: true, nextCursor: true,
+  },
+});
+
+if (page.mediaAssets.length > 0) {
+  const { getPartnerMediaAsset: asset } = await client.query({
+    getPartnerMediaAsset: {
+      __args: { uid: page.mediaAssets[0].uid },
+      uid: true, url: true, mimeType: true,
+    },
+  });
+}
+```
+
+Only look up a UID after checking that a page contains an asset. Lookup returns
+`null` for missing, archived, unlinked, or other-brand assets. Transform fields
+may be null while processing is pending. Agents need `READ_MEDIA` for both reads.
+
+Agent sessions may also use `getPartnerUploadUrl` and `createPartnerMediaAsset`
+with `UPLOAD_MEDIA`. PUT the bytes to the returned presigned URL, then register
+with the exact returned `filename` and the caller-supplied `mimetype` and
+`dimensions`. Add both
+`idempotencyKey` and `toolCallId` (nonblank, at most 255 characters) to registration.
+Persist the filename and registration payload before registering; after an
+unknown result, retry that same payload and key rather than requesting a fresh
+upload key. Replays return the same asset UID. The backend checks object existence
+and brand ownership and records an audit entry. Partner-token callers must omit
+both audit identifiers and retain their existing upload flow.
+
+Deploy the backend media schema and migration before releasing this SDK contract.

package/dist/index.d.mts

@@ -4,8 +4,8 @@ type Scalars = {
     ID: string;
     String: string;
     Boolean: boolean;
-    Int: number;
     Float: number;
+    Int: number;
 };
 type ConsentStatus = 'NEVER_SUBSCRIBED' | 'SUBSCRIBED' | 'UNSUBSCRIBED';
 type UserSource = 'BRAND' | 'DICE' | 'ITM';
@@ -20,8 +20,8 @@ type MusicReleaseType = 'ALBUM' | 'EP' | 'SINGLE';
 type MomentType = 'DIGITAL' | 'HYBRID' | 'IRL';
 type MomentOnlineProvider = 'GOOGLE_MEET' | 'MS_TEAMS' | 'OTHER' | 'ZOOM';
 type TicketAttendanceMode = 'IN_PERSON' | 'ONLINE';
-type MomentCategory = 'ACTIVATION' | 'CONCERT' | 'DIGITAL' | 'DINING' | 'EDUCATION' | 'EXHIBITION' | 'FASHION' | 'FESTIVAL' | 'LAUNCH' | 'NIGHTLIFE' | 'OTHER' | 'PARTY' | 'PERFORMING_ARTS' | 'SCREENING' | 'SPORTS' | 'WELLNESS';
-type MomentSubcategory = 'ACOUSTIC_SET' | 'ADVANCE_SCREENING' | 'AFTER_PARTY' | 'AIRDROP' | 'ALBUM_DROP' | 'ALBUM_RELEASE_SHOW' | 'AMA' | 'ANNIVERSARY' | 'ARTIST_TALK' | 'ART_FAIR' | 'ART_FESTIVAL' | 'ATHLETE_APPEARANCE' | 'AWARDS' | 'BAR_TAKEOVER' | 'BATTLE' | 'BEER_AND_WINE_FESTIVAL' | 'BIENNALE' | 'BIRTHDAY' | 'BLOCK_PARTY' | 'BRAND_EXPERIENCE' | 'BRAND_REVEAL' | 'BREATHWORK' | 'BRUNCH_EVENT' | 'BURLESQUE' | 'CACAO_CEREMONY' | 'CARNIVAL' | 'CELEBRATION' | 'CHAMPIONSHIP' | 'CHEF_DINNER' | 'CHOIR_OR_ENSEMBLE' | 'CLUB_NIGHT' | 'CLUB_SET' | 'COLD_PLUNGE' | 'COLLABORATION_REVEAL' | 'COLLECTION_DROP' | 'COMEDY_FESTIVAL' | 'COMEDY_NIGHT' | 'COMEDY_SHOW' | 'COMMUNITY_MEETUP' | 'CONFERENCE' | 'COOKING_CLASS' | 'CULTURAL_FESTIVAL' | 'DANCE_PERFORMANCE' | 'DAYCLUB' | 'DIRECTORS_CUT' | 'DISCORD_EVENT' | 'DOCUMENTARY' | 'DRAG_SHOW' | 'ECSTATIC_DANCE' | 'ESPORTS' | 'EXHIBITION_GAME' | 'EXTREME_SPORTS' | 'FAN_EXPERIENCE' | 'FAN_FEST' | 'FASHION_FESTIVAL' | 'FASHION_PANEL' | 'FASHION_WEEK' | 'FIGHT_NIGHT' | 'FILM_FESTIVAL' | 'FILM_PREMIERE' | 'FINISSAGE' | 'FIRESIDE_CHAT' | 'FITNESS_CLASS' | 'FITTING_EVENT' | 'FOOD_FESTIVAL' | 'FOOD_PAIRING' | 'GALLERY_OPENING' | 'GAME_DAY' | 'GIVEAWAY' | 'GROUP_EXHIBITION' | 'GUERRILLA' | 'HACKATHON' | 'HEADLINER_SHOW' | 'HOLIDAY_PARTY' | 'HYBRID_EVENT' | 'IMMERSIVE_EXPERIENCE' | 'IMPROV_SHOW' | 'INFLUENCER_EVENT' | 'INSTALLATION' | 'INTERACTIVE_INSTALLATION' | 'JAZZ_NIGHT' | 'JAZZ_SESSION' | 'KARAOKE_NIGHT' | 'KEYNOTE' | 'LATE_NIGHT_SET' | 'LISTENING_PARTY' | 'LIVESTREAM' | 'LOOKBOOK_SHOOT' | 'MASQUERADE' | 'MASTERCLASS' | 'MEDITATION' | 'MEET_AND_GREET' | 'MEMBERS_ONLY' | 'MOBILE_TOUR' | 'MUSEUM_EVENT' | 'MUSICAL' | 'MUSIC_FESTIVAL' | 'MUSIC_VIDEO_PREMIERE' | 'NETWORKING_MIXER' | 'NFT_MINT' | 'ONLINE_DROP' | 'ONLINE_PREMIERE' | 'ONLINE_WATCH_PARTY' | 'OPEN_MIC' | 'OPERA' | 'ORCHESTRA' | 'OTHER' | 'OUTDOOR_CINEMA' | 'PANEL' | 'PERFORMANCE_ART' | 'PHOTO_ACTIVATION' | 'POOL_PARTY' | 'POP_UP_BOUTIQUE' | 'POP_UP_DINING' | 'POP_UP_GALLERY' | 'POP_UP_SHOP' | 'PRESENTATION' | 'PRESS_EVENT' | 'PREVIEW' | 'PRIDE_FESTIVAL' | 'PRIVATE_EVENT' | 'PRODUCT_LAUNCH' | 'RAVE' | 'RELEASE_PARTY' | 'RESIDENCY' | 'RESTAURANT_OPENING' | 'RETREAT' | 'RIVALRY_GAME' | 'ROOFTOP_PARTY' | 'ROUNDTABLE' | 'RUNWAY_SHOW' | 'RUN_CLUB' | 'RUN_OR_RACE' | 'SAMPLE_SALE' | 'SAMPLING' | 'SECRET_DINING' | 'SEMINAR' | 'SHORT_FILM' | 'SHOWCASE' | 'SHOWROOM' | 'SILENT_DISCO' | 'SOCIAL_CHALLENGE' | 'SOLO_EXHIBITION' | 'SOUND_BATH' | 'SPA_EXPERIENCE' | 'SPOKEN_WORD' | 'SPONSORSHIP' | 'SPORTS_CLINIC' | 'SPORTS_WATCH_PARTY' | 'STANDUP_COMEDY' | 'STREET_TEAM' | 'STUDIO_VISIT' | 'SUMMIT' | 'SUPPER_CLUB' | 'TAILGATE' | 'TASTING' | 'THEATER' | 'THEMED_NIGHT' | 'TOURNAMENT' | 'TOUR_STOP' | 'TRIBUTE_SHOW' | 'TRUNK_SHOW' | 'TWITTER_SPACE' | 'VARIETY_SHOW' | 'VENUE_OPENING' | 'VIRTUAL_CONCERT' | 'VIRTUAL_EVENT' | 'WAREHOUSE_PARTY' | 'WATCH_PARTY' | 'WEBINAR' | 'WELLNESS_FESTIVAL' | 'WELLNESS_WORKSHOP' | 'WORKSHOP' | 'YOGA_SESSION';
+type MomentCategory = 'ACTIVATION' | 'BUSINESS' | 'COMMUNITY' | 'CONCERT' | 'DIGITAL' | 'DINING' | 'EDUCATION' | 'EXHIBITION' | 'FASHION' | 'FESTIVAL' | 'LAUNCH' | 'NIGHTLIFE' | 'OTHER' | 'PARTY' | 'PERFORMING_ARTS' | 'SCREENING' | 'SPORTS' | 'WELLNESS';
+type MomentSubcategory = 'ACOUSTIC_SET' | 'ADVANCE_SCREENING' | 'AFTER_PARTY' | 'AIRDROP' | 'ALBUM_DROP' | 'ALBUM_RELEASE_SHOW' | 'AMA' | 'ANNIVERSARY' | 'APP_LAUNCH' | 'ARTIST_POP_UP' | 'ARTIST_RECEPTION' | 'ARTIST_TALK' | 'ART_FAIR' | 'ART_FESTIVAL' | 'ATHLETE_APPEARANCE' | 'AWARDS' | 'BAR_TAKEOVER' | 'BATTLE' | 'BEAUTY_FASHION_EVENT' | 'BEER_AND_WINE_FESTIVAL' | 'BEER_TASTING' | 'BIENNALE' | 'BIRTHDAY' | 'BLOCK_PARTY' | 'BOOK_LAUNCH' | 'BOOK_TALK' | 'BRAND_EXPERIENCE' | 'BRAND_REVEAL' | 'BREATHWORK' | 'BRUNCH_EVENT' | 'BURLESQUE' | 'BUSINESS_MIXER' | 'CACAO_CEREMONY' | 'CAREER_FAIR' | 'CARNIVAL' | 'CELEBRATION' | 'CHAMPIONSHIP' | 'CHARITY_EVENT' | 'CHEF_DINNER' | 'CHOIR_OR_ENSEMBLE' | 'CLASS' | 'CLUB_MEETING' | 'CLUB_NIGHT' | 'CLUB_SET' | 'COLD_PLUNGE' | 'COLLABORATION_REVEAL' | 'COLLECTION_DROP' | 'COMEDY_FESTIVAL' | 'COMEDY_NIGHT' | 'COMEDY_SHOW' | 'COMMUNITY_FESTIVAL' | 'COMMUNITY_MARKET' | 'COMMUNITY_MEETUP' | 'CONFERENCE' | 'COOKING_CLASS' | 'COURSE' | 'CREATOR_POP_UP' | 'CULTURAL_FESTIVAL' | 'CULTURAL_GATHERING' | 'DANCE_PARTY' | 'DANCE_PERFORMANCE' | 'DAYCLUB' | 'DEMO_DAY' | 'DESIGNER_MEET_AND_GREET' | 'DESIGN_EXHIBITION' | 'DINNER_PARTY' | 'DIRECTORS_CUT' | 'DISCORD_EVENT' | 'DOCUMENTARY' | 'DRAG_SHOW' | 'ECSTATIC_DANCE' | 'ESPORTS' | 'EXHIBITION_GAME' | 'EXTREME_SPORTS' | 'FAMILY_EVENT' | 'FAN_EXPERIENCE' | 'FAN_FEST' | 'FASHION_FESTIVAL' | 'FASHION_PANEL' | 'FASHION_WEEK' | 'FIGHT_NIGHT' | 'FILM_FESTIVAL' | 'FILM_PREMIERE' | 'FILM_SCREENING' | 'FINISSAGE' | 'FIRESIDE_CHAT' | 'FITNESS_CLASS' | 'FITTING_EVENT' | 'FOOD_FESTIVAL' | 'FOOD_MARKET' | 'FOOD_PAIRING' | 'FOUNDER_MEETUP' | 'FUNDRAISER' | 'GALLERY_OPENING' | 'GAME_DAY' | 'GAME_LAUNCH' | 'GAMING_STREAM' | 'GIVEAWAY' | 'GROUP_EXHIBITION' | 'GUERRILLA' | 'HACKATHON' | 'HEADLINER_SHOW' | 'HIIT_CLASS' | 'HOLIDAY_PARTY' | 'HYBRID_EVENT' | 'IMMERSIVE_EXPERIENCE' | 'IMPROV_SHOW' | 'INDUSTRY_PANEL' | 'INFLUENCER_EVENT' | 'INSTALLATION' | 'INTERACTIVE_INSTALLATION' | 'INVESTOR_EVENT' | 'JAM_SESSION' | 'JAZZ_NIGHT' | 'JAZZ_SESSION' | 'JOB_FAIR' | 'KARAOKE_NIGHT' | 'KEYNOTE' | 'LATE_NIGHT_SET' | 'LATIN_NIGHT' | 'LECTURE' | 'LISTENING_PARTY' | 'LIVESTREAM' | 'LIVE_AUDIO_ROOM' | 'LIVE_PERFORMANCE' | 'LIVE_PODCAST' | 'LOCAL_MEETUP' | 'LOOKBOOK_SHOOT' | 'MAGIC_SHOW' | 'MASQUERADE' | 'MASTERCLASS' | 'MEDITATION' | 'MEET_AND_GREET' | 'MEMBERS_ONLY' | 'MIXOLOGY_CLASS' | 'MOBILE_TOUR' | 'MUSEUM_EVENT' | 'MUSICAL' | 'MUSIC_FESTIVAL' | 'MUSIC_VIDEO_PREMIERE' | 'NETWORKING_EVENT' | 'NETWORKING_MIXER' | 'NFT_MINT' | 'NUTRITION_WORKSHOP' | 'OFFICE_HOURS' | 'ONLINE_CLASS' | 'ONLINE_COURSE' | 'ONLINE_DROP' | 'ONLINE_LECTURE' | 'ONLINE_OFFICE_HOURS' | 'ONLINE_PREMIERE' | 'ONLINE_WATCH_PARTY' | 'OPEN_DECKS' | 'OPEN_HOUSE' | 'OPEN_MIC' | 'OPERA' | 'ORCHESTRA' | 'OTHER' | 'OUTDOOR_CINEMA' | 'PANEL' | 'PERFORMANCE_ART' | 'PHOTO_ACTIVATION' | 'PHOTO_EXHIBITION' | 'PICKUP_GAME' | 'PILATES_CLASS' | 'PITCH_NIGHT' | 'POOL_PARTY' | 'POP_UP_BOUTIQUE' | 'POP_UP_DINING' | 'POP_UP_GALLERY' | 'POP_UP_SHOP' | 'PRESENTATION' | 'PRESS_EVENT' | 'PREVIEW' | 'PRIDE_FESTIVAL' | 'PRIVATE_EVENT' | 'PRODUCT_DEMO' | 'PRODUCT_LAUNCH' | 'Q_AND_A_SCREENING' | 'RAVE' | 'READING' | 'RELEASE_PARTY' | 'RESIDENCY' | 'RESTAURANT_OPENING' | 'RETREAT' | 'RIVALRY_GAME' | 'ROOFTOP_PARTY' | 'ROUNDTABLE' | 'RUNWAY_SHOW' | 'RUN_CLUB' | 'RUN_OR_RACE' | 'SAMPLE_SALE' | 'SAMPLING' | 'SECRET_DINING' | 'SEMINAR' | 'SERIES_SCREENING' | 'SHORT_FILM' | 'SHOWCASE' | 'SHOWROOM' | 'SILENT_DISCO' | 'SKATE_JAM' | 'SOCIAL_CHALLENGE' | 'SOLO_EXHIBITION' | 'SONGWRITER_ROUND' | 'SOUND_BATH' | 'SPA_EXPERIENCE' | 'SPOKEN_WORD' | 'SPONSORSHIP' | 'SPORTS_CLINIC' | 'SPORTS_TRAINING' | 'SPORTS_WATCH_PARTY' | 'STANDUP_COMEDY' | 'STORYTELLING' | 'STREAMING_RELEASE' | 'STREET_TEAM' | 'STUDIO_VISIT' | 'STUDY_GROUP' | 'STYLING_SESSION' | 'SUMMIT' | 'SUPPER_CLUB' | 'TAILGATE' | 'TASTING' | 'TECH_FESTIVAL' | 'THEATER' | 'THEMED_NIGHT' | 'TOURNAMENT' | 'TOUR_STOP' | 'TOWN_HALL' | 'TRADE_SHOW' | 'TRAINING' | 'TRIBUTE_SHOW' | 'TRUNK_SHOW' | 'TV_PREMIERE' | 'TWITTER_SPACE' | 'VARIETY_SHOW' | 'VENUE_OPENING' | 'VIRTUAL_CONCERT' | 'VIRTUAL_EVENT' | 'VIRTUAL_EXPO' | 'VIRTUAL_MEETUP' | 'VIRTUAL_NETWORKING' | 'VIRTUAL_SUMMIT' | 'VIRTUAL_WORKSHOP' | 'VOLUNTEER_EVENT' | 'WAREHOUSE_PARTY' | 'WATCH_PARTY' | 'WEBINAR' | 'WELLNESS_FESTIVAL' | 'WELLNESS_WORKSHOP' | 'WINE_TASTING' | 'WORKSHOP' | 'YOGA_SESSION';
 type MomentLineupStatus = 'APPROVED' | 'PENDING' | 'REJECTED';
 type MomentLineupType = 'CO_HOST' | 'DJ' | 'LINEUP' | 'PROMOTER' | 'SPEAKER' | 'VENDOR';
 /** Display label for the lineup section on public event pages. */
@@ -30,6 +30,7 @@ type EchoType = 'LINK' | 'POST' | 'IMAGE' | 'VIDEO' | 'GALLERY' | 'MERCH' | 'AUD
 type ThirdPartyEchoType = 'SPOTIFY' | 'INSTAGRAM' | 'TIKTOK';
 type PaymentStatus = 'PENDING' | 'SUCCEEDED' | 'FAILED';
 type TicketExtensionStatus = 'PENDING' | 'APPLIED' | 'CANCELLED' | 'EXPIRED' | 'FAILED' | 'REFUNDED';
+type TagSource = 'MANUAL' | 'AUTO';
 interface Currency {
     uid: Scalars['ID'];
     code: Scalars['String'];
@@ -81,6 +82,27 @@ interface MomentCoverImage {
     mimeType: Scalars['String'];
     __typename: 'MomentCoverImage';
 }
+interface Tag {
+    uid: Scalars['ID'];
+    name: Scalars['String'];
+    createdAt: Scalars['DateTime'];
+    updatedAt: Scalars['DateTime'];
+    __typename: 'Tag';
+}
+interface MomentTagAssignment {
+    tag: Tag;
+    source: TagSource;
+    isPublic: Scalars['Boolean'];
+    confidence: Scalars['Float'];
+    __typename: 'MomentTagAssignment';
+}
+interface GetMomentTagAssignmentsResponse {
+    assignments: MomentTagAssignment[];
+    totalCount: Scalars['Int'];
+    hasNextPage: Scalars['Boolean'];
+    nextCursor: (Scalars['String'] | null);
+    __typename: 'GetMomentTagAssignmentsResponse';
+}
 interface Moment {
     uid: Scalars['ID'];
     name: Scalars['String'];
@@ -105,6 +127,8 @@ interface Moment {
     /** Cover image for the moment. Null if no cover image is set. */
     coverImage: MomentCoverImage;
     venue: (Venue | null);
+    /** Public tag assignments owned by the authenticated partner's brand. */
+    momentTags: GetMomentTagAssignmentsResponse;
     ticketTiers: TicketTier[];
     createdAt: Scalars['DateTime'];
     updatedAt: Scalars['DateTime'];
@@ -650,7 +674,18 @@ interface AgentThreadSeedContext {
     truncated: Scalars['Boolean'];
     __typename: 'AgentThreadSeedContext';
 }
+interface GetPartnerMediaAssetsResponse {
+    mediaAssets: MediaAsset[];
+    totalCount: Scalars['Int'];
+    hasNextPage: Scalars['Boolean'];
+    nextCursor: (Scalars['String'] | null);
+    __typename: 'GetPartnerMediaAssetsResponse';
+}
 interface Query {
+    /** Active brand-linked assets, newest first. Defaults to 50, capped at 100. READ_MEDIA for agents. */
+    getPartnerMediaAssets: GetPartnerMediaAssetsResponse;
+    /** An active asset linked to the caller's brand; null when unavailable. READ_MEDIA for agents. */
+    getPartnerMediaAsset: (MediaAsset | null);
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand: PartnerBrand;
     /** Retrieve one AgentMail send batch owned by the authenticated partner brand. */
@@ -748,10 +783,19 @@ interface MediaAsset {
     size: Scalars['Int'];
     placeholderUrl: (Scalars['String'] | null);
     blurhash: (Scalars['String'] | null);
+    transforms: (Transforms | null);
     createdAt: Scalars['DateTime'];
     updatedAt: Scalars['DateTime'];
     __typename: 'MediaAsset';
 }
+interface Transforms {
+    original: Scalars['String'];
+    small: (Scalars['String'] | null);
+    medium: (Scalars['String'] | null);
+    large: (Scalars['String'] | null);
+    hls: (Scalars['String'] | null);
+    __typename: 'Transforms';
+}
 interface CreatePartnerBrandSubscriptionResponse {
     subscription: (BrandSubscription | null);
     verificationRequired: Scalars['Boolean'];
@@ -851,6 +895,34 @@ interface MomentCoverImageGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface TagGenqlSelection {
+    uid?: boolean | number;
+    name?: boolean | number;
+    createdAt?: boolean | number;
+    updatedAt?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
+interface MomentTagAssignmentGenqlSelection {
+    tag?: TagGenqlSelection;
+    source?: boolean | number;
+    isPublic?: boolean | number;
+    confidence?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
+interface GetMomentTagAssignmentsResponseGenqlSelection {
+    assignments?: MomentTagAssignmentGenqlSelection;
+    totalCount?: boolean | number;
+    hasNextPage?: boolean | number;
+    nextCursor?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
+interface PaginationInput {
+    cursor?: (Scalars['String'] | null);
+    take?: (Scalars['Float'] | null);
+}
 interface MomentGenqlSelection {
     uid?: boolean | number;
     name?: boolean | number;
@@ -875,6 +947,13 @@ interface MomentGenqlSelection {
     /** Cover image for the moment. Null if no cover image is set. */
     coverImage?: MomentCoverImageGenqlSelection;
     venue?: VenueGenqlSelection;
+    /** Public tag assignments owned by the authenticated partner's brand. */
+    momentTags?: (GetMomentTagAssignmentsResponseGenqlSelection & {
+        __args?: {
+            pagination?: (PaginationInput | null);
+            sources?: (TagSource[] | null);
+        };
+    });
     ticketTiers?: TicketTierGenqlSelection;
     createdAt?: boolean | number;
     updatedAt?: boolean | number;
@@ -1509,7 +1588,33 @@ interface AgentThreadSeedContextGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface GetPartnerMediaAssetsInput {
+    cursor?: (Scalars['String'] | null);
+    take?: (Scalars['Int'] | null);
+    /** Case-insensitive MIME prefix, for example image/ or application/pdf. */
+    mimeTypePrefix?: (Scalars['String'] | null);
+}
+interface GetPartnerMediaAssetsResponseGenqlSelection {
+    mediaAssets?: MediaAssetGenqlSelection;
+    totalCount?: boolean | number;
+    hasNextPage?: boolean | number;
+    nextCursor?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface QueryGenqlSelection {
+    /** Active brand-linked assets, newest first. Defaults to 50, capped at 100. READ_MEDIA for agents. */
+    getPartnerMediaAssets?: (GetPartnerMediaAssetsResponseGenqlSelection & {
+        __args: {
+            input: GetPartnerMediaAssetsInput;
+        };
+    });
+    /** An active asset linked to the caller's brand; null when unavailable. READ_MEDIA for agents. */
+    getPartnerMediaAsset?: (MediaAssetGenqlSelection & {
+        __args: {
+            uid: Scalars['String'];
+        };
+    });
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand?: PartnerBrandGenqlSelection;
     /** Retrieve one AgentMail send batch owned by the authenticated partner brand. */
@@ -1897,6 +2002,12 @@ interface PostSubscriptionMessageInput {
 }
 interface CreatePartnerBrandSubscriptionInput {
     compliance?: (SubscriptionComplianceInput | null);
+    /**
+     * Exact opt-in disclosure the subscriber accepted, stored as consent evidence
+     * alongside the subscription compliance record. Send the verbatim text shown on
+     * your signup surface — it is the record of what the subscriber agreed to.
+     */
+    consentText?: (Scalars['String'] | null);
     email?: (Scalars['String'] | null);
     /** Optional full name. If provided, include first and last name. */
     fullName?: (Scalars['String'] | null);
@@ -1944,11 +2055,21 @@ interface MediaAssetGenqlSelection {
     size?: boolean | number;
     placeholderUrl?: boolean | number;
     blurhash?: boolean | number;
+    transforms?: TransformsGenqlSelection;
     createdAt?: boolean | number;
     updatedAt?: boolean | number;
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface TransformsGenqlSelection {
+    original?: boolean | number;
+    small?: boolean | number;
+    medium?: boolean | number;
+    large?: boolean | number;
+    hls?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface CreatePartnerBrandSubscriptionResponseGenqlSelection {
     subscription?: BrandSubscriptionGenqlSelection;
     verificationRequired?: boolean | number;
@@ -1976,6 +2097,10 @@ interface MutationGenqlSelection {
             mimetype: Scalars['String'];
             filename: Scalars['String'];
             dimensions: DimensionsInput;
+            /** Required for agent sessions; omit for partner tokens. Reuse with the same upload payload on retry. */
+            idempotencyKey?: (Scalars['String'] | null);
+            /** Required for agent sessions; omit for partner tokens. */
+            toolCallId?: (Scalars['String'] | null);
         };
     });
     /**
@@ -2235,4 +2360,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type AgentThreadSeedContext, type ApplyDynamicPricingInput, type BrandAgentEmailMessageInput, type BrandAgentEmailSendBatch, type BrandAgentEmailSendBatchStatus, type BrandAgentEmailSendMessage, type BrandAgentEmailSendMessageStatus, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type ConsentStatus, 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, GenqlError, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetPartnerAudienceInput, type GetPartnerAudienceResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerAgentAccessConfig, type ITMPartnerAgentAccessCredentials, type ITMPartnerAgentSessionConfig, type ITMPartnerAgentSessionCredentials, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type ITMPartnerTokenConfig, 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 PartnerAudienceCustomer, type PartnerAudienceFiltersInput, type PartnerAudienceSortField, type PartnerAudienceSortInput, 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 SendPartnerAgentEmailInput, type SortDirection, type SubscriptionComplianceInput, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type UserSource, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };
+export { type AgentThreadSeedContext, type ApplyDynamicPricingInput, type BrandAgentEmailMessageInput, type BrandAgentEmailSendBatch, type BrandAgentEmailSendBatchStatus, type BrandAgentEmailSendMessage, type BrandAgentEmailSendMessageStatus, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type ConsentStatus, 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, GenqlError, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetMomentTagAssignmentsResponse, type GetPartnerAudienceInput, type GetPartnerAudienceResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerMediaAssetsInput, type GetPartnerMediaAssetsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerAgentAccessConfig, type ITMPartnerAgentAccessCredentials, type ITMPartnerAgentSessionConfig, type ITMPartnerAgentSessionCredentials, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type ITMPartnerTokenConfig, 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 MomentTagAssignment, type MomentType, type MusicReleaseType, type Mutation, type PaginationInput, type PartnerAudienceCustomer, type PartnerAudienceFiltersInput, type PartnerAudienceSortField, type PartnerAudienceSortInput, 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 SendPartnerAgentEmailInput, type SortDirection, type SubscriptionComplianceInput, type Tag, type TagSource, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type Transforms, type User, type UserSource, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };