@getlatedev/node 0.2.1103 → 0.2.1105

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -355,6 +355,48 @@ export type Ad = {
355
355
  * All media URLs for this ad (carousel images, multiple assets). Populated for Meta (carousel child_attachments), Google Ads (responsive display marketing_images), and LinkedIn (multi-image posts).
356
356
  */
357
357
  mediaUrls?: Array<(string)>;
358
+ /**
359
+ * Meta only today. The carousel's cards in the order the ad shows them, one per
360
+ * Meta `link_data.child_attachments` entry, using the same field names as the
361
+ * `carouselCards` create input. On a carousel synced from Meta, `imageUrl` is resolved
362
+ * exactly like `mediaUrls` (the stable `/adimages` permalink first), so the cards that
363
+ * carry an image line up with `mediaUrls` in order; a card whose image Meta does not
364
+ * resolve keeps its place without `imageUrl`. On a carousel created through Zernio
365
+ * it starts as the cards you sent. Absent on non-carousel ads and on
366
+ * other platforms. Synced carousels stored before this field existed fill it in on
367
+ * their next sync.
368
+ *
369
+ */
370
+ carouselCards?: Array<{
371
+ /**
372
+ * Card image, resolved like the matching `mediaUrls` entry. Absent when Meta returns no resolvable image for the card.
373
+ */
374
+ imageUrl?: string;
375
+ /**
376
+ * Meta ad image hash of the card image (`image_hash`).
377
+ */
378
+ imageHash?: string;
379
+ /**
380
+ * Card title (Meta `name`).
381
+ */
382
+ headline?: string;
383
+ /**
384
+ * Card description, under the title (Meta `description`).
385
+ */
386
+ description?: string;
387
+ /**
388
+ * Card destination URL (Meta `link`).
389
+ */
390
+ linkUrl?: string;
391
+ /**
392
+ * Card call to action type (Meta `call_to_action.type`), e.g. SHOP_NOW or WATCH_MORE.
393
+ */
394
+ callToAction?: string;
395
+ /**
396
+ * Meta video id when the card is a video (`video_id`).
397
+ */
398
+ videoId?: string;
399
+ }>;
358
400
  /**
359
401
  * LinkedIn only. Whether LinkedIn is currently serving this specific creative. Complements the ad-level `servingStatuses`, which describes the parent campaign.
360
402
  */
@@ -10288,7 +10330,7 @@ export type contentType3 = 'story' | 'saved_story' | 'spotlight';
10288
10330
 
10289
10331
  export type SocialAccount = {
10290
10332
  _id: string;
10291
- platform: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'shopify' | 'wordpress' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'sms' | 'phone' | 'rcs';
10333
+ platform: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'shopify' | 'wordpress' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'sms' | 'phone' | 'rcs' | 'whopads';
10292
10334
  profileId: (string | Profile);
10293
10335
  username?: string;
10294
10336
  displayName?: string;
@@ -10370,7 +10412,7 @@ export type SocialAccount = {
10370
10412
  };
10371
10413
  };
10372
10414
 
10373
- export type platform11 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'shopify' | 'wordpress' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'sms' | 'phone' | 'rcs';
10415
+ export type platform11 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'shopify' | 'wordpress' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'sms' | 'phone' | 'rcs' | 'whopads';
10374
10416
 
10375
10417
  /**
10376
10418
  * A tracking tag's install on a connected store: a Shopify web pixel, or a Custom HTML widget on a WordPress site. Fields marked Shopify or WordPress are present only for that platform.
@@ -10943,7 +10985,7 @@ export type TrackingTag = {
10943
10985
  */
10944
10986
  events?: Array<TrackingTagEvent>;
10945
10987
  name: string;
10946
- platform: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
10988
+ platform: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads' | 'whopads';
10947
10989
  /**
10948
10990
  * Platform-native flavor of the tag (Meta: `pixel`).
10949
10991
  */
@@ -10998,7 +11040,7 @@ export type TrackingTag = {
10998
11040
  autoTagging?: boolean;
10999
11041
  };
11000
11042
 
11001
- export type platform12 = 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
11043
+ export type platform12 = 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads' | 'whopads';
11002
11044
 
11003
11045
  /**
11004
11046
  * Platform-native flavor of the tag (Meta: `pixel`).
@@ -19013,7 +19055,7 @@ export type GetAllAccountsHealthData = {
19013
19055
  /**
19014
19056
  * Filter by platform
19015
19057
  */
19016
- platform?: 'facebook' | 'instagram' | 'linkedin' | 'twitter' | 'tiktok' | 'youtube' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'shopify' | 'wordpress' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads';
19058
+ platform?: 'facebook' | 'instagram' | 'linkedin' | 'twitter' | 'tiktok' | 'youtube' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'shopify' | 'wordpress' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'whopads';
19017
19059
  /**
19018
19060
  * Filter by profile ID
19019
19061
  */
@@ -23016,6 +23058,97 @@ export type ConnectOpenAiAdsCredentialsError = (ErrorResponse | unknown | {
23016
23058
  };
23017
23059
  });
23018
23060
 
23061
+ export type ConnectWhopAdsCredentialsData = {
23062
+ body: {
23063
+ /**
23064
+ * Account API key from the Whop dashboard.
23065
+ */
23066
+ apiKey: string;
23067
+ /**
23068
+ * Your Zernio profile ID
23069
+ */
23070
+ profileId: string;
23071
+ /**
23072
+ * Optional state passthrough for the connect flow.
23073
+ */
23074
+ state?: string;
23075
+ /**
23076
+ * Optional URL to redirect to after successful connection, echoed back as redirectUrl.
23077
+ */
23078
+ redirect_url?: string;
23079
+ };
23080
+ };
23081
+
23082
+ export type ConnectWhopAdsCredentialsResponse = ({
23083
+ /**
23084
+ * The Zernio account id (platform `whopads`) to use as `{accountId}` on the tracking-tags routes.
23085
+ */
23086
+ accountId?: string;
23087
+ /**
23088
+ * The Whop account id (`biz_...`), which is also the tracking tag id.
23089
+ */
23090
+ whopAccountId?: string;
23091
+ accountName?: string;
23092
+ redirectUrl?: string;
23093
+ });
23094
+
23095
+ export type ConnectWhopAdsCredentialsError = (ErrorResponse | unknown | {
23096
+ /**
23097
+ * Human-readable error message suitable for end-user display.
23098
+ */
23099
+ error: string;
23100
+ /**
23101
+ * Machine-readable error code. Stable across versions.
23102
+ */
23103
+ code: 'PAYMENT_REQUIRED';
23104
+ /**
23105
+ * Discriminator for which gate fired.
23106
+ */
23107
+ reason: 'free_tier_exceeded' | 'twitter_passthrough' | 'enterprise_required' | 'card_verification_required';
23108
+ /**
23109
+ * Link to the relevant documentation page.
23110
+ */
23111
+ documentation_url?: string;
23112
+ /**
23113
+ * Deep-link to send the end-user to. For
23114
+ * `free_tier_exceeded` and `twitter_passthrough` this opens
23115
+ * the add-payment-method drawer on the Zernio billing page.
23116
+ * For `enterprise_required` this is the Zernio enterprise
23117
+ * contact page.
23118
+ *
23119
+ */
23120
+ dashboard_url?: string;
23121
+ /**
23122
+ * Structured context for SDK clients that want to render their own UX. Keys vary by `reason`.
23123
+ */
23124
+ details?: {
23125
+ /**
23126
+ * How many accounts the free tier allows. Only set when reason=free_tier_exceeded.
23127
+ */
23128
+ free_tier_account_limit?: number;
23129
+ /**
23130
+ * How many accounts the team currently has connected. Set when reason=free_tier_exceeded or reason=enterprise_required.
23131
+ */
23132
+ current_account_count?: number;
23133
+ /**
23134
+ * Whether the team currently has a card on file in Stripe. Set when reason=free_tier_exceeded or reason=twitter_passthrough.
23135
+ */
23136
+ has_payment_method?: boolean;
23137
+ /**
23138
+ * One-time card verification charge in USD cents, credited to usage. Only set when reason=card_verification_required.
23139
+ */
23140
+ verification_amount_cents?: number;
23141
+ /**
23142
+ * The negotiated connected-account cap from the
23143
+ * team's enterprise contract. Self-service teams
23144
+ * have no cap and never receive this reason. Only
23145
+ * set when reason=enterprise_required.
23146
+ *
23147
+ */
23148
+ effective_account_limit?: number;
23149
+ };
23150
+ });
23151
+
23019
23152
  export type ConnectWhatsAppCredentialsData = {
23020
23153
  body: {
23021
23154
  /**
@@ -51860,7 +51993,7 @@ export type ListTrackingTagsData = {
51860
51993
  };
51861
51994
 
51862
51995
  export type ListTrackingTagsResponse = ({
51863
- platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
51996
+ platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads' | 'whopads';
51864
51997
  tags?: Array<TrackingTag>;
51865
51998
  });
51866
51999
 
@@ -51891,7 +52024,7 @@ export type CreateTrackingTagData = {
51891
52024
  };
51892
52025
 
51893
52026
  export type CreateTrackingTagResponse = ({
51894
- platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
52027
+ platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads' | 'whopads';
51895
52028
  tag?: TrackingTag;
51896
52029
  });
51897
52030
 
@@ -51914,7 +52047,7 @@ export type GetTrackingTagData = {
51914
52047
  };
51915
52048
 
51916
52049
  export type GetTrackingTagResponse = ({
51917
- platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
52050
+ platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads' | 'whopads';
51918
52051
  tag?: TrackingTag;
51919
52052
  });
51920
52053
 
@@ -51960,7 +52093,7 @@ export type UpdateTrackingTagData = {
51960
52093
  };
51961
52094
 
51962
52095
  export type UpdateTrackingTagResponse = ({
51963
- platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
52096
+ platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads' | 'whopads';
51964
52097
  tag?: TrackingTag;
51965
52098
  });
51966
52099
 
@@ -52055,7 +52188,7 @@ export type InstallTrackingTagOnStoreData = {
52055
52188
  };
52056
52189
 
52057
52190
  export type InstallTrackingTagOnStoreResponse = ({
52058
- platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
52191
+ platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads' | 'whopads';
52059
52192
  install?: (StorePixelInstall & {
52060
52193
  /**
52061
52194
  * Shopify only: the pixel this install replaced on the store, if any.
@@ -52108,7 +52241,7 @@ export type GetTrackingTagStoreInstallData = {
52108
52241
  };
52109
52242
 
52110
52243
  export type GetTrackingTagStoreInstallResponse = ({
52111
- platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
52244
+ platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads' | 'whopads';
52112
52245
  install?: (StorePixelInstall & {
52113
52246
  /**
52114
52247
  * WordPress only.
@@ -52156,7 +52289,7 @@ export type RemoveTrackingTagFromStoreData = {
52156
52289
  };
52157
52290
 
52158
52291
  export type RemoveTrackingTagFromStoreResponse = ({
52159
- platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
52292
+ platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads' | 'whopads';
52160
52293
  install?: (StorePixelInstall & {
52161
52294
  /**
52162
52295
  * WordPress only: number of Zernio widgets deleted.
@@ -52375,7 +52508,7 @@ export type GetTrackingTagStatsData = {
52375
52508
  };
52376
52509
 
52377
52510
  export type GetTrackingTagStatsResponse = ({
52378
- platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
52511
+ platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads' | 'whopads';
52379
52512
  stats?: {
52380
52513
  aggregation?: string;
52381
52514
  startTime?: number;