@itm-studio/partner-sdk 0.3.2 → 0.3.3

package/README.md

@@ -1879,3 +1879,9 @@ 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.
+
+### Automatic operator CC for Eve
+
+Agent-session email callers first query `getPartnerAgentEmailContext { operatorCcEmail }`, show that address with every email draft, and include `operatorCcEmail` in `SendPartnerAgentEmailInput` after approval. The backend verifies it against the authenticated admin, snapshots it on the batch, and CCs that address on each message. When the operator is already the primary recipient, no duplicate CC is added. Read the approved snapshot through `BrandAgentEmailSendBatch.operatorCcEmail`. A changed operator address before queuing requires a revised draft and approval; queued retries retain the original address.
+
+Partner API-key callers cannot query operator context or supply operator CC. Existing partner sends and the brand Reply-To address retain their existing behavior.

package/dist/index.d.mts

@@ -654,7 +654,12 @@ interface BrandAgentEmailSendMessage {
     lastErrorMessage: (Scalars['String'] | null);
     __typename: 'BrandAgentEmailSendMessage';
 }
+interface BrandAgentEmailContext {
+    operatorCcEmail: Scalars['String'];
+    __typename: 'BrandAgentEmailContext';
+}
 interface BrandAgentEmailSendBatch {
+    operatorCcEmail: (Scalars['String'] | null);
     uid: Scalars['String'];
     createdAt: Scalars['DateTime'];
     status: BrandAgentEmailSendBatchStatus;
@@ -682,6 +687,8 @@ interface GetPartnerMediaAssetsResponse {
     __typename: 'GetPartnerMediaAssetsResponse';
 }
 interface Query {
+    /** Get the authenticated agent operator email for the approval preview. Requires a brand-agent session with SEND_EMAIL; unavailable to partner API keys. */
+    getPartnerAgentEmailContext: BrandAgentEmailContext;
     /** 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. */
@@ -1566,7 +1573,13 @@ interface BrandAgentEmailSendMessageGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface BrandAgentEmailContextGenqlSelection {
+    operatorCcEmail?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface BrandAgentEmailSendBatchGenqlSelection {
+    operatorCcEmail?: boolean | number;
     uid?: boolean | number;
     createdAt?: boolean | number;
     status?: boolean | number;
@@ -1603,6 +1616,8 @@ interface GetPartnerMediaAssetsResponseGenqlSelection {
     __scalar?: boolean | number;
 }
 interface QueryGenqlSelection {
+    /** Get the authenticated agent operator email for the approval preview. Requires a brand-agent session with SEND_EMAIL; unavailable to partner API keys. */
+    getPartnerAgentEmailContext?: BrandAgentEmailContextGenqlSelection;
     /** Active brand-linked assets, newest first. Defaults to 50, capped at 100. READ_MEDIA for agents. */
     getPartnerMediaAssets?: (GetPartnerMediaAssetsResponseGenqlSelection & {
         __args: {
@@ -1790,6 +1805,8 @@ interface BrandAgentEmailMessageInput {
     text: Scalars['String'];
 }
 interface SendPartnerAgentEmailInput {
+    /** Required for agent callers: operator CC from getPartnerAgentEmailContext, shown in the approved draft. Partner callers cannot set this. */
+    operatorCcEmail?: (Scalars['String'] | null);
     /** Stable business idempotency key for this logical batch. */
     idempotencyKey: Scalars['String'];
     /** One to ten personalized, single-recipient plain-text emails. */

package/dist/index.d.ts

@@ -654,7 +654,12 @@ interface BrandAgentEmailSendMessage {
     lastErrorMessage: (Scalars['String'] | null);
     __typename: 'BrandAgentEmailSendMessage';
 }
+interface BrandAgentEmailContext {
+    operatorCcEmail: Scalars['String'];
+    __typename: 'BrandAgentEmailContext';
+}
 interface BrandAgentEmailSendBatch {
+    operatorCcEmail: (Scalars['String'] | null);
     uid: Scalars['String'];
     createdAt: Scalars['DateTime'];
     status: BrandAgentEmailSendBatchStatus;
@@ -682,6 +687,8 @@ interface GetPartnerMediaAssetsResponse {
     __typename: 'GetPartnerMediaAssetsResponse';
 }
 interface Query {
+    /** Get the authenticated agent operator email for the approval preview. Requires a brand-agent session with SEND_EMAIL; unavailable to partner API keys. */
+    getPartnerAgentEmailContext: BrandAgentEmailContext;
     /** 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. */
@@ -1566,7 +1573,13 @@ interface BrandAgentEmailSendMessageGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface BrandAgentEmailContextGenqlSelection {
+    operatorCcEmail?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface BrandAgentEmailSendBatchGenqlSelection {
+    operatorCcEmail?: boolean | number;
     uid?: boolean | number;
     createdAt?: boolean | number;
     status?: boolean | number;
@@ -1603,6 +1616,8 @@ interface GetPartnerMediaAssetsResponseGenqlSelection {
     __scalar?: boolean | number;
 }
 interface QueryGenqlSelection {
+    /** Get the authenticated agent operator email for the approval preview. Requires a brand-agent session with SEND_EMAIL; unavailable to partner API keys. */
+    getPartnerAgentEmailContext?: BrandAgentEmailContextGenqlSelection;
     /** Active brand-linked assets, newest first. Defaults to 50, capped at 100. READ_MEDIA for agents. */
     getPartnerMediaAssets?: (GetPartnerMediaAssetsResponseGenqlSelection & {
         __args: {
@@ -1790,6 +1805,8 @@ interface BrandAgentEmailMessageInput {
     text: Scalars['String'];
 }
 interface SendPartnerAgentEmailInput {
+    /** Required for agent callers: operator CC from getPartnerAgentEmailContext, shown in the approved draft. Partner callers cannot set this. */
+    operatorCcEmail?: (Scalars['String'] | null);
     /** Stable business idempotency key for this logical batch. */
     idempotencyKey: Scalars['String'];
     /** One to ten personalized, single-recipient plain-text emails. */

package/dist/index.js

@@ -1547,10 +1547,10 @@ var types_default = {
         27
       ],
       "coverImage": [
-        126
+        127
       ],
       "coverImageMobile": [
-        126
+        127
       ],
       "isActive": [
         33
@@ -2324,7 +2324,18 @@ var types_default = {
         27
       ]
     },
+    "BrandAgentEmailContext": {
+      "operatorCcEmail": [
+        27
+      ],
+      "__typename": [
+        27
+      ]
+    },
     "BrandAgentEmailSendBatch": {
+      "operatorCcEmail": [
+        27
+      ],
       "uid": [
         27
       ],
@@ -2380,7 +2391,7 @@ var types_default = {
     },
     "GetPartnerMediaAssetsResponse": {
       "mediaAssets": [
-        126
+        127
       ],
       "totalCount": [
         36
@@ -2396,17 +2407,20 @@ var types_default = {
       ]
     },
     "Query": {
+      "getPartnerAgentEmailContext": [
+        98
+      ],
       "getPartnerMediaAssets": [
-        101,
+        102,
         {
           "input": [
-            100,
+            101,
             "GetPartnerMediaAssetsInput!"
           ]
         }
       ],
       "getPartnerMediaAsset": [
-        126,
+        127,
         {
           "uid": [
             27,
@@ -2418,7 +2432,7 @@ var types_default = {
         28
       ],
       "getPartnerAgentEmailBatch": [
-        98,
+        99,
         {
           "batchUid": [
             27,
@@ -2427,7 +2441,7 @@ var types_default = {
         }
       ],
       "getAgentThreadSeed": [
-        99
+        100
       ],
       "getPartnerMomentsForBrand": [
         65,
@@ -2564,7 +2578,7 @@ var types_default = {
         73,
         {
           "input": [
-            110,
+            111,
             "GetPartnerTicketTiersForMomentInput!"
           ]
         }
@@ -2573,7 +2587,7 @@ var types_default = {
         86,
         {
           "input": [
-            113,
+            114,
             "DynamicPricingMomentInput!"
           ]
         }
@@ -2644,11 +2658,14 @@ var types_default = {
       ]
     },
     "SendPartnerAgentEmailInput": {
+      "operatorCcEmail": [
+        27
+      ],
       "idempotencyKey": [
         27
       ],
       "messages": [
-        104
+        105
       ],
       "toolCallId": [
         27
@@ -2758,10 +2775,10 @@ var types_default = {
         27
       ],
       "venue": [
-        106
+        107
       ],
       "onlineConfig": [
-        108
+        109
       ],
       "isPrivate": [
         33
@@ -2776,7 +2793,7 @@ var types_default = {
         16
       ],
       "ticketTiers": [
-        107
+        108
       ],
       "idempotencyKey": [
         27
@@ -2890,7 +2907,7 @@ var types_default = {
         27
       ],
       "updates": [
-        111
+        112
       ],
       "__typename": [
         27
@@ -2921,7 +2938,7 @@ var types_default = {
         27
       ],
       "inventoryGuard": [
-        115
+        116
       ],
       "externalSignals": [
         1
@@ -2979,7 +2996,7 @@ var types_default = {
         1
       ],
       "updates": [
-        114
+        115
       ],
       "__typename": [
         27
@@ -3099,13 +3116,13 @@ var types_default = {
     },
     "PostSubscriptionMessageInput": {
       "sms": [
-        119
+        120
       ],
       "email": [
-        120
+        121
       ],
       "push": [
-        121
+        122
       ],
       "__typename": [
         27
@@ -3113,7 +3130,7 @@ var types_default = {
     },
     "CreatePartnerBrandSubscriptionInput": {
       "compliance": [
-        118
+        119
       ],
       "consentText": [
         27
@@ -3134,7 +3151,7 @@ var types_default = {
         33
       ],
       "postSubscriptionMessage": [
-        122
+        123
       ],
       "__typename": [
         27
@@ -3188,7 +3205,7 @@ var types_default = {
         27
       ],
       "transforms": [
-        127
+        128
       ],
       "createdAt": [
         0
@@ -3236,7 +3253,7 @@ var types_default = {
     },
     "Mutation": {
       "getPartnerUploadUrl": [
-        125,
+        126,
         {
           "filename": [
             27,
@@ -3249,7 +3266,7 @@ var types_default = {
         }
       ],
       "createPartnerMediaAsset": [
-        126,
+        127,
         {
           "mimetype": [
             27,
@@ -3260,7 +3277,7 @@ var types_default = {
             "String!"
           ],
           "dimensions": [
-            103,
+            104,
             "DimensionsInput!"
           ],
           "idempotencyKey": [
@@ -3272,10 +3289,10 @@ var types_default = {
         }
       ],
       "createPartnerBrandSubscription": [
-        128,
+        129,
         {
           "input": [
-            123,
+            124,
             "CreatePartnerBrandSubscriptionInput!"
           ]
         }
@@ -3284,16 +3301,16 @@ var types_default = {
         38,
         {
           "input": [
-            109,
+            110,
             "CreatePartnerMomentInput!"
           ]
         }
       ],
       "sendPartnerAgentEmail": [
-        98,
+        99,
         {
           "input": [
-            105,
+            106,
             "SendPartnerAgentEmailInput!"
           ]
         }
@@ -3302,7 +3319,7 @@ var types_default = {
         72,
         {
           "input": [
-            112,
+            113,
             "EditPartnerTicketTiersForMomentInput!"
           ]
         }
@@ -3311,7 +3328,7 @@ var types_default = {
         89,
         {
           "input": [
-            116,
+            117,
             "ApplyDynamicPricingInput!"
           ]
         }
@@ -3320,7 +3337,7 @@ var types_default = {
         90,
         {
           "input": [
-            124,
+            125,
             "VerifyPartnerBrandSubscriptionInput!"
           ]
         }
@@ -3329,7 +3346,7 @@ var types_default = {
         92,
         {
           "input": [
-            117,
+            118,
             "RespondToMomentLineupInput!"
           ]
         }