@getlatedev/node 0.2.1356 → 0.2.1358

package/dist/index.d.mts

@@ -11430,6 +11430,19 @@ type InstagramPlatformData = {
      * Up to 3 Instagram usernames to invite as collaborators (feed/Reels only)
      */
     collaborators?: Array<(string)>;
+    /**
+     * Output only. Set by Zernio when Instagram rejected these collaborators and the retry was sent without them.
+     */
+    readonly droppedCollaborators?: Array<{
+        /**
+         * The collaborator username Instagram rejected
+         */
+        username: string;
+        /**
+         * The reason Instagram gave for rejecting the collaborator
+         */
+        reason: string;
+    }>;
     /**
      * Optional first comment to add after the post is created (not applied to Stories)
      */
@@ -55689,7 +55702,7 @@ type ListAdAudiencesData = {
          * Platform ad account ID
          */
         adAccountId: string;
-        platform?: 'facebook' | 'instagram' | 'googleads' | 'tiktok' | 'tiktokads' | 'pinterest' | 'linkedin' | 'linkedinads' | 'twitter' | 'xads';
+        platform?: 'facebook' | 'instagram' | 'googleads' | 'tiktok' | 'tiktokads' | 'pinterest' | 'linkedin' | 'linkedinads' | 'twitter' | 'xads' | 'redditads';
         /**
          * Filter to one audience type. `saved_targeting` returns stored TargetingSpec audiences; the other types return uploaded/derived audiences.
          */
@@ -55709,7 +55722,10 @@ type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        /**
+         * `reddit_engagement`, `third_party` and `in_market` are listed from Reddit (engagement retargeting, and Reddit's own audiences) so they can be targeted. Zernio cannot create them.
+         */
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting' | 'reddit_engagement' | 'third_party' | 'in_market';
         /**
          * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
          */
@@ -55792,11 +55808,11 @@ type CreateAdAudienceData = {
             linkedinPageUrl?: string;
         }>;
         /**
-         * website: the Meta pixel, TikTok pixel or Pinterest tag id. Required on those three, rejected on Google.
+         * website: the Meta pixel, TikTok pixel, Pinterest tag or Reddit pixel id. Required on those four, rejected on Google.
          */
         pixelId?: string;
         /**
-         * Required for website (Meta max 180, TikTok 7/14/30/60/90/180, Pinterest and Google max 540), meta_engagement (max 365) and tiktok_engagement (7/14/30/60/90/180; organic and live video and most business-account events only 7/14/30).
+         * Required for website (Meta max 180, TikTok 7/14/30/60/90/180, Reddit max 90, Pinterest and Google max 540), meta_engagement (max 365) and tiktok_engagement (7/14/30/60/90/180; organic and live video and most business-account events only 7/14/30).
          */
         retentionDays?: number;
         /**
@@ -55815,6 +55831,8 @@ type CreateAdAudienceData = {
          * (page → page_engaged, instagram → ig_business_profile_all,
          * video → video_watched). Ignored when `rule` is provided.
          *
+         * website on Reddit: the conversion event (default `PAGE_VISIT`), or a custom event name.
+         *
          * website on TikTok: the pixel event (default `PAGE BROWSE`). website
          * on Pinterest: the tag event (`pagevisit`, `signup`, `checkout`, `viewcategory`, `search`, `addtocart`, `watchvideo`, `lead`, `custom` or a partner-defined event).
          *
@@ -56026,7 +56044,7 @@ type AddUsersToAdAudienceResponse = ({
     message?: string;
     numReceived?: number;
     /**
-     * Rows the platform could not read. Returned on Meta only.
+     * Rows the platform could not read. Returned on Meta, and on Reddit for rows without a valid email.
      */
     numInvalid?: number;
 });
@@ -56050,11 +56068,11 @@ type RemoveUsersFromAdAudienceData = {
 type RemoveUsersFromAdAudienceResponse = ({
     message?: string;
     /**
-     * Rows Meta received.
+     * Rows the platform received.
      */
     numReceived?: number;
     /**
-     * Rows Meta could not read.
+     * Rows the platform could not read.
      */
     numInvalid?: number;
     /**

package/dist/index.d.ts

@@ -11430,6 +11430,19 @@ type InstagramPlatformData = {
      * Up to 3 Instagram usernames to invite as collaborators (feed/Reels only)
      */
     collaborators?: Array<(string)>;
+    /**
+     * Output only. Set by Zernio when Instagram rejected these collaborators and the retry was sent without them.
+     */
+    readonly droppedCollaborators?: Array<{
+        /**
+         * The collaborator username Instagram rejected
+         */
+        username: string;
+        /**
+         * The reason Instagram gave for rejecting the collaborator
+         */
+        reason: string;
+    }>;
     /**
      * Optional first comment to add after the post is created (not applied to Stories)
      */
@@ -55689,7 +55702,7 @@ type ListAdAudiencesData = {
          * Platform ad account ID
          */
         adAccountId: string;
-        platform?: 'facebook' | 'instagram' | 'googleads' | 'tiktok' | 'tiktokads' | 'pinterest' | 'linkedin' | 'linkedinads' | 'twitter' | 'xads';
+        platform?: 'facebook' | 'instagram' | 'googleads' | 'tiktok' | 'tiktokads' | 'pinterest' | 'linkedin' | 'linkedinads' | 'twitter' | 'xads' | 'redditads';
         /**
          * Filter to one audience type. `saved_targeting` returns stored TargetingSpec audiences; the other types return uploaded/derived audiences.
          */
@@ -55709,7 +55722,10 @@ type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        /**
+         * `reddit_engagement`, `third_party` and `in_market` are listed from Reddit (engagement retargeting, and Reddit's own audiences) so they can be targeted. Zernio cannot create them.
+         */
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting' | 'reddit_engagement' | 'third_party' | 'in_market';
         /**
          * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
          */
@@ -55792,11 +55808,11 @@ type CreateAdAudienceData = {
             linkedinPageUrl?: string;
         }>;
         /**
-         * website: the Meta pixel, TikTok pixel or Pinterest tag id. Required on those three, rejected on Google.
+         * website: the Meta pixel, TikTok pixel, Pinterest tag or Reddit pixel id. Required on those four, rejected on Google.
          */
         pixelId?: string;
         /**
-         * Required for website (Meta max 180, TikTok 7/14/30/60/90/180, Pinterest and Google max 540), meta_engagement (max 365) and tiktok_engagement (7/14/30/60/90/180; organic and live video and most business-account events only 7/14/30).
+         * Required for website (Meta max 180, TikTok 7/14/30/60/90/180, Reddit max 90, Pinterest and Google max 540), meta_engagement (max 365) and tiktok_engagement (7/14/30/60/90/180; organic and live video and most business-account events only 7/14/30).
          */
         retentionDays?: number;
         /**
@@ -55815,6 +55831,8 @@ type CreateAdAudienceData = {
          * (page → page_engaged, instagram → ig_business_profile_all,
          * video → video_watched). Ignored when `rule` is provided.
          *
+         * website on Reddit: the conversion event (default `PAGE_VISIT`), or a custom event name.
+         *
          * website on TikTok: the pixel event (default `PAGE BROWSE`). website
          * on Pinterest: the tag event (`pagevisit`, `signup`, `checkout`, `viewcategory`, `search`, `addtocart`, `watchvideo`, `lead`, `custom` or a partner-defined event).
          *
@@ -56026,7 +56044,7 @@ type AddUsersToAdAudienceResponse = ({
     message?: string;
     numReceived?: number;
     /**
-     * Rows the platform could not read. Returned on Meta only.
+     * Rows the platform could not read. Returned on Meta, and on Reddit for rows without a valid email.
      */
     numInvalid?: number;
 });
@@ -56050,11 +56068,11 @@ type RemoveUsersFromAdAudienceData = {
 type RemoveUsersFromAdAudienceResponse = ({
     message?: string;
     /**
-     * Rows Meta received.
+     * Rows the platform received.
      */
     numReceived?: number;
     /**
-     * Rows Meta could not read.
+     * Rows the platform could not read.
      */
     numInvalid?: number;
     /**

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1356",
+  version: "0.2.1358",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1356",
+  version: "0.2.1358",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlatedev/node",
-  "version": "0.2.1356",
+  "version": "0.2.1358",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -15126,7 +15126,10 @@ export const deleteAdCatalogProductSet = <ThrowOnError extends boolean = false>(
  * List custom audiences
  * Lists the custom audiences in an ad account so you can reuse them for targeting.
  *
- * Supports Meta, Google, TikTok, Pinterest, LinkedIn, and X.
+ * Supports Meta, Google, TikTok, Pinterest, LinkedIn, X, and Reddit.
+ *
+ * On Reddit, `size` is the lower bound of Reddit's matched-users range, and `status` is `too_small`
+ * while the list has matched fewer than 1,000 people.
  *
  */
 export const listAdAudiences = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListAdAudiencesData, ThrowOnError>) => {
@@ -15140,8 +15143,10 @@ export const listAdAudiences = <ThrowOnError extends boolean = false>(options: O
  * Create custom audience
  * Creates a custom audience from a customer list, website visitors, a lookalike, or people who engaged with your content.
  *
- * `customer_list` is supported on Meta, Google, X, LinkedIn, TikTok, and Pinterest.
- * `website` (pixel/tag visitors) and `lookalike` are supported on Meta, TikTok, Pinterest and Google.
+ * `customer_list` is supported on Meta, Google, X, LinkedIn, TikTok, Pinterest, and Reddit.
+ * `website` (pixel/tag visitors) is supported on Meta, TikTok, Pinterest, Google, and Reddit.
+ * `lookalike` is supported on Meta, TikTok, Pinterest and Google (Reddit's API cannot create one).
+ * Reddit audience names need at least 3 characters.
  * `meta_engagement` is Meta-only, `tiktok_engagement` TikTok-only, `pinterest_engagement` Pinterest-only;
  * `company_list`, `engagement` and `website_retargeting` are LinkedIn-only. A type sent to a platform
  * that does not support it is a 422 `FEATURE_NOT_AVAILABLE`.
@@ -15158,6 +15163,9 @@ export const listAdAudiences = <ThrowOnError extends boolean = false>(options: O
  * Pinterest matches URLs exactly, so `urlContains` is a 400 there.
  * - Google: no `pixelId` (the account's Google tag is used), `retentionDays` 1-540, `urlContains`
  * defaults to `/` (all visitors). Built as a rule-based user list with prepopulation requested.
+ * - Reddit: `pixelId` is the Reddit pixel id, `retentionDays` 1-90. `event` is a Reddit conversion event
+ * (`PAGE_VISIT` by default; also `VIEW_CONTENT`, `SEARCH`, `ADD_TO_CART`, `ADD_TO_WISHLIST`, `PURCHASE`,
+ * `LEAD`, `SIGN_UP`); any other value is sent as a custom event name. `urlContains` and `rule` are a 400.
  *
  * Per-platform rules for `lookalike`: Meta takes `ratio` (0.01-0.20); Pinterest takes `ratio` in whole
  * percents (0.01-0.10) and `country` US, CA or GB; TikTok and Google take `size` (narrow, balanced, broad)
@@ -15225,7 +15233,7 @@ export const updateAdAudience = <ThrowOnError extends boolean = false>(options:
  * Removes a custom audience from its ad platform (archiving it where the platform does not delete).
  *
  * Removes the audience on its ad platform, then deletes the Zernio record. Meta, Google, TikTok,
- * LinkedIn list and engagement segments, and X are deleted; Pinterest audiences and LinkedIn
+ * LinkedIn list and engagement segments, X, and Reddit are deleted; Pinterest audiences and LinkedIn
  * `website_retargeting` segments are archived, which is how those platforms remove them.
  * `saved_targeting` audiences exist only on Zernio, so only the local record is removed.
  *
@@ -15248,6 +15256,9 @@ export const deleteAdAudience = <ThrowOnError extends boolean = false>(options:
  * Data is SHA256-hashed server-side before sending to the platform.
  * Email is used on every platform; phone is used on Meta only (other platforms ignore it). On TikTok and Pinterest,
  * the first upload also provisions the audience (deferred create). LinkedIn uploads are full-replace. Max 10,000 users per request.
+ * On Reddit, emails are lowercased and trimmed before hashing, duplicates are sent once, and the upload goes out
+ * in batches of 2,500. Reddit matches by email only: rows without a valid email count in `numInvalid`, and a
+ * request where no row has one is a 400. Reddit audiences need the `redditads` connection, not the Reddit posting account (422).
  *
  * customer_list only. A LinkedIn `company_list` audience takes company rows, not people: send those to
  * `POST /v1/ads/audiences/{audienceId}/companies`. This endpoint 422s for every other audience type.
@@ -15262,13 +15273,13 @@ export const addUsersToAdAudience = <ThrowOnError extends boolean = false>(optio
 
 /**
  * Remove users from audience
- * Removes customer emails and phone numbers from a Meta customer list audience. Same body as
+ * Removes customer emails (and phone numbers on Meta) from a Meta or Reddit customer list audience. Same body as
  * `POST /v1/ads/audiences/{audienceId}/users`: send plaintext rows, they are normalized and
  * SHA256-hashed server-side exactly like an upload, so a row removes the person it added.
  *
- * Meta only, customer_list only. Every other platform returns 422 with code `feature_not_available`,
- * and every other audience type returns 422. Max 10,000 users per request. Meta applies the removal
- * asynchronously, so the audience size does not drop immediately.
+ * Meta and Reddit only, customer_list only. Every other platform returns 422 with code `feature_not_available`,
+ * and every other audience type returns 422. Max 10,000 users per request. The platform applies the removal
+ * asynchronously, so the audience size does not drop immediately. On Reddit `invalidEntrySamples` is always empty.
  *
  */
 export const removeUsersFromAdAudience = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveUsersFromAdAudienceData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -9681,6 +9681,19 @@ export type InstagramPlatformData = {
      * Up to 3 Instagram usernames to invite as collaborators (feed/Reels only)
      */
     collaborators?: Array<(string)>;
+    /**
+     * Output only. Set by Zernio when Instagram rejected these collaborators and the retry was sent without them.
+     */
+    readonly droppedCollaborators?: Array<{
+        /**
+         * The collaborator username Instagram rejected
+         */
+        username: string;
+        /**
+         * The reason Instagram gave for rejecting the collaborator
+         */
+        reason: string;
+    }>;
     /**
      * Optional first comment to add after the post is created (not applied to Stories)
      */
@@ -56873,7 +56886,7 @@ export type ListAdAudiencesData = {
          * Platform ad account ID
          */
         adAccountId: string;
-        platform?: 'facebook' | 'instagram' | 'googleads' | 'tiktok' | 'tiktokads' | 'pinterest' | 'linkedin' | 'linkedinads' | 'twitter' | 'xads';
+        platform?: 'facebook' | 'instagram' | 'googleads' | 'tiktok' | 'tiktokads' | 'pinterest' | 'linkedin' | 'linkedinads' | 'twitter' | 'xads' | 'redditads';
         /**
          * Filter to one audience type. `saved_targeting` returns stored TargetingSpec audiences; the other types return uploaded/derived audiences.
          */
@@ -56894,7 +56907,10 @@ export type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        /**
+         * `reddit_engagement`, `third_party` and `in_market` are listed from Reddit (engagement retargeting, and Reddit's own audiences) so they can be targeted. Zernio cannot create them.
+         */
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting' | 'reddit_engagement' | 'third_party' | 'in_market';
         /**
          * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
          */
@@ -56979,11 +56995,11 @@ export type CreateAdAudienceData = {
         linkedinPageUrl?: string;
     }>;
     /**
-     * website: the Meta pixel, TikTok pixel or Pinterest tag id. Required on those three, rejected on Google.
+     * website: the Meta pixel, TikTok pixel, Pinterest tag or Reddit pixel id. Required on those four, rejected on Google.
      */
     pixelId?: string;
     /**
-     * Required for website (Meta max 180, TikTok 7/14/30/60/90/180, Pinterest and Google max 540), meta_engagement (max 365) and tiktok_engagement (7/14/30/60/90/180; organic and live video and most business-account events only 7/14/30).
+     * Required for website (Meta max 180, TikTok 7/14/30/60/90/180, Reddit max 90, Pinterest and Google max 540), meta_engagement (max 365) and tiktok_engagement (7/14/30/60/90/180; organic and live video and most business-account events only 7/14/30).
      */
     retentionDays?: number;
     /**
@@ -57002,6 +57018,8 @@ export type CreateAdAudienceData = {
      * (page → page_engaged, instagram → ig_business_profile_all,
      * video → video_watched). Ignored when `rule` is provided.
      *
+     * website on Reddit: the conversion event (default `PAGE_VISIT`), or a custom event name.
+     *
      * website on TikTok: the pixel event (default `PAGE BROWSE`). website
      * on Pinterest: the tag event (`pagevisit`, `signup`, `checkout`, `viewcategory`, `search`, `addtocart`, `watchvideo`, `lead`, `custom` or a partner-defined event).
      *
@@ -57226,7 +57244,7 @@ export type AddUsersToAdAudienceResponse = ({
     message?: string;
     numReceived?: number;
     /**
-     * Rows the platform could not read. Returned on Meta only.
+     * Rows the platform could not read. Returned on Meta, and on Reddit for rows without a valid email.
      */
     numInvalid?: number;
 });
@@ -57253,11 +57271,11 @@ export type RemoveUsersFromAdAudienceData = {
 export type RemoveUsersFromAdAudienceResponse = ({
     message?: string;
     /**
-     * Rows Meta received.
+     * Rows the platform received.
      */
     numReceived?: number;
     /**
-     * Rows Meta could not read.
+     * Rows the platform could not read.
      */
     numInvalid?: number;
     /**