@getlatedev/node 0.2.1217 → 0.2.1219

package/dist/index.d.mts

@@ -42272,6 +42272,44 @@ type UpdateAdSetData = {
              */
             interestsBehaviors?: boolean;
         };
+        /**
+         * Meta only (400 elsewhere). Manual placements, same object and enums as `placements` on
+         * POST /v1/ads/create. Sending an object REPLACES the ad set's current placement set
+         * (`publisher_platforms`, every `*_positions` list and `device_platforms`); a position
+         * list you leave out is removed. `null` removes every placement key so Meta returns to
+         * automatic (Advantage+) placements. Omit to leave placements untouched. Meta enforces
+         * co-selection rules (e.g. a position needs its publisher platform) and its error is
+         * returned as is. Meta may also reject `null` or a narrower set when an ad's creative
+         * uses per-placement asset customization (`placementAssets`). An object with no
+         * non-empty list is a 400 (send `null` instead). Cannot be combined with
+         * `targeting.placements` (400).
+         *
+         */
+        placements?: {
+            publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network' | 'whatsapp')>;
+            facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+            instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+            messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+            audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+            threadsPositions?: Array<('threads_stream')>;
+            whatsappPositions?: Array<('status')>;
+            devicePlatforms?: Array<('mobile' | 'desktop')>;
+        } | null;
+        /**
+         * Meta only (400 elsewhere). Targeting fields to change, same shape as the `targeting`
+         * object on POST /v1/ads/create. Only the keys you send change: Zernio reads the ad set's
+         * live targeting from Meta, merges these keys over it and writes the full spec back, so
+         * everything you do not send (custom audiences, geo, age, interest groups,
+         * `targeting_automation`) is kept. Setting any location replaces every location list.
+         * An empty list or `gender: all` clears that key. `incomeTier` is resolved to Meta's
+         * income segment first (422 when Meta has none). Fields Meta cannot target (LinkedIn
+         * B2B, Google `devices`, Reddit communities and keywords) return 400 with
+         * `param: targeting.<field>`. An empty object is a 400, and so is a
+         * `targeting.placements` object with no non-empty list (`param: targeting.placements`). When the live targeting cannot be
+         * read the request returns 502 and nothing is written.
+         *
+         */
+        targeting?: (TargetingSpec);
         /**
          * Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when
          * bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's
@@ -42407,6 +42445,12 @@ type UpdateAdSetResponse = ({
     platformSpecificData?: {
         [key: string]: unknown;
     };
+    /**
+     * Present when `placements` or `targeting` was sent. The ad set's full Meta targeting as written (Meta snake_case). The same snake_case object is stored as the ad set's and its ads' `targeting`.
+     */
+    targeting?: {
+        [key: string]: unknown;
+    };
 });
 type UpdateAdSetError = (unknown | ErrorResponse);
 type DeleteAdSetData = {
@@ -49395,9 +49439,9 @@ type SearchAdTargetingData = {
          */
         countryCode?: string;
         /**
-         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities (`behavior` on Meta, TikTok and LinkedIn), `interestKeyword`/`hashtag` resolve TikTok additional interests and hashtags (TikTok only), `income` resolves the normalized income tiers, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
+         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities (`behavior` on Meta, TikTok and LinkedIn), `interestSuggestion` suggests interests related to the names in `q` (Meta only), `interestKeyword`/`hashtag` resolve TikTok additional interests and hashtags (TikTok only), `income` resolves the normalized income tiers, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
          */
-        dimension?: 'geo' | 'interest' | 'interestKeyword' | 'behavior' | 'hashtag' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize' | 'community' | 'conversationKeyword';
+        dimension?: 'geo' | 'interest' | 'interestSuggestion' | 'interestKeyword' | 'behavior' | 'hashtag' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize' | 'community' | 'conversationKeyword';
         /**
          * Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
          */
@@ -49407,7 +49451,7 @@ type SearchAdTargetingData = {
          */
         limit?: number;
         /**
-         * Search query. For geo, the locality name only (no region/country suffix).
+         * Search query. For geo, the locality name only (no region/country suffix). For `interestSuggestion`, the interest names: comma-separated, or a JSON array of strings when a name contains a comma (a `q` starting with `[` is read as JSON).
          */
         q: string;
     };
@@ -49423,7 +49467,7 @@ type SearchAdTargetingResponse = ({
          */
         name: string;
         /**
-         * What the result is. Equals the requested dimension (interest, interestKeyword, behavior, hashtag, income, language, workPosition, workEmployer, workIndustry, industry, jobFunction, seniority, companySize, community, conversationKeyword), or the location level for geo (country, region, city, zip, metro, ...).
+         * What the result is. Equals the requested dimension (interest, interestSuggestion, interestKeyword, behavior, hashtag, income, language, workPosition, workEmployer, workIndustry, industry, jobFunction, seniority, companySize, community, conversationKeyword), or the location level for geo (country, region, city, zip, metro, ...).
          */
         type: string;
         /**

package/dist/index.d.ts

@@ -42272,6 +42272,44 @@ type UpdateAdSetData = {
              */
             interestsBehaviors?: boolean;
         };
+        /**
+         * Meta only (400 elsewhere). Manual placements, same object and enums as `placements` on
+         * POST /v1/ads/create. Sending an object REPLACES the ad set's current placement set
+         * (`publisher_platforms`, every `*_positions` list and `device_platforms`); a position
+         * list you leave out is removed. `null` removes every placement key so Meta returns to
+         * automatic (Advantage+) placements. Omit to leave placements untouched. Meta enforces
+         * co-selection rules (e.g. a position needs its publisher platform) and its error is
+         * returned as is. Meta may also reject `null` or a narrower set when an ad's creative
+         * uses per-placement asset customization (`placementAssets`). An object with no
+         * non-empty list is a 400 (send `null` instead). Cannot be combined with
+         * `targeting.placements` (400).
+         *
+         */
+        placements?: {
+            publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network' | 'whatsapp')>;
+            facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+            instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+            messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+            audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+            threadsPositions?: Array<('threads_stream')>;
+            whatsappPositions?: Array<('status')>;
+            devicePlatforms?: Array<('mobile' | 'desktop')>;
+        } | null;
+        /**
+         * Meta only (400 elsewhere). Targeting fields to change, same shape as the `targeting`
+         * object on POST /v1/ads/create. Only the keys you send change: Zernio reads the ad set's
+         * live targeting from Meta, merges these keys over it and writes the full spec back, so
+         * everything you do not send (custom audiences, geo, age, interest groups,
+         * `targeting_automation`) is kept. Setting any location replaces every location list.
+         * An empty list or `gender: all` clears that key. `incomeTier` is resolved to Meta's
+         * income segment first (422 when Meta has none). Fields Meta cannot target (LinkedIn
+         * B2B, Google `devices`, Reddit communities and keywords) return 400 with
+         * `param: targeting.<field>`. An empty object is a 400, and so is a
+         * `targeting.placements` object with no non-empty list (`param: targeting.placements`). When the live targeting cannot be
+         * read the request returns 502 and nothing is written.
+         *
+         */
+        targeting?: (TargetingSpec);
         /**
          * Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when
          * bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's
@@ -42407,6 +42445,12 @@ type UpdateAdSetResponse = ({
     platformSpecificData?: {
         [key: string]: unknown;
     };
+    /**
+     * Present when `placements` or `targeting` was sent. The ad set's full Meta targeting as written (Meta snake_case). The same snake_case object is stored as the ad set's and its ads' `targeting`.
+     */
+    targeting?: {
+        [key: string]: unknown;
+    };
 });
 type UpdateAdSetError = (unknown | ErrorResponse);
 type DeleteAdSetData = {
@@ -49395,9 +49439,9 @@ type SearchAdTargetingData = {
          */
         countryCode?: string;
         /**
-         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities (`behavior` on Meta, TikTok and LinkedIn), `interestKeyword`/`hashtag` resolve TikTok additional interests and hashtags (TikTok only), `income` resolves the normalized income tiers, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
+         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities (`behavior` on Meta, TikTok and LinkedIn), `interestSuggestion` suggests interests related to the names in `q` (Meta only), `interestKeyword`/`hashtag` resolve TikTok additional interests and hashtags (TikTok only), `income` resolves the normalized income tiers, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
          */
-        dimension?: 'geo' | 'interest' | 'interestKeyword' | 'behavior' | 'hashtag' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize' | 'community' | 'conversationKeyword';
+        dimension?: 'geo' | 'interest' | 'interestSuggestion' | 'interestKeyword' | 'behavior' | 'hashtag' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize' | 'community' | 'conversationKeyword';
         /**
          * Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
          */
@@ -49407,7 +49451,7 @@ type SearchAdTargetingData = {
          */
         limit?: number;
         /**
-         * Search query. For geo, the locality name only (no region/country suffix).
+         * Search query. For geo, the locality name only (no region/country suffix). For `interestSuggestion`, the interest names: comma-separated, or a JSON array of strings when a name contains a comma (a `q` starting with `[` is read as JSON).
          */
         q: string;
     };
@@ -49423,7 +49467,7 @@ type SearchAdTargetingResponse = ({
          */
         name: string;
         /**
-         * What the result is. Equals the requested dimension (interest, interestKeyword, behavior, hashtag, income, language, workPosition, workEmployer, workIndustry, industry, jobFunction, seniority, companySize, community, conversationKeyword), or the location level for geo (country, region, city, zip, metro, ...).
+         * What the result is. Equals the requested dimension (interest, interestSuggestion, interestKeyword, behavior, hashtag, income, language, workPosition, workEmployer, workIndustry, industry, jobFunction, seniority, companySize, community, conversationKeyword), or the location level for geo (country, region, city, zip, metro, ...).
          */
         type: string;
         /**

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1217",
+  version: "0.2.1219",
   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.1217",
+  version: "0.2.1219",
   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.1217",
+  "version": "0.2.1219",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -10540,6 +10540,17 @@ export const getAdSetDetails = <ThrowOnError extends boolean = false>(options: O
  * theirs, and `statusUpdated` / `statusSkipped` report whether that switch
  * was written or a live read showed it already in place.
  *
+ * Placements and targeting (Meta only): `placements` and `targeting` take the same shapes
+ * as POST /v1/ads/create. Meta replaces an ad set's targeting wholesale, so Zernio reads
+ * the live targeting first, changes only what the request names and writes the merged
+ * spec back: custom audiences, geo, age, interest groups and `targeting_automation` you do
+ * not send are kept. `placements` replaces the whole placement set, `placements: null`
+ * returns the ad set to automatic placements, and omitting it leaves placements as they
+ * are. Other platforms return 400 for either field before anything in the request is
+ * written (use PUT /v1/ads/{adId} with `targeting` where that platform supports it). The
+ * live read and the `incomeTier` lookup run before any other field is written, so a 502
+ * or 422 from them leaves the ad set unchanged.
+ *
  */
 export const updateAdSet = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateAdSetData, ThrowOnError>) => {
     return (options?.client ?? client).put<UpdateAdSetResponse, UpdateAdSetError, ThrowOnError>({
@@ -13166,6 +13177,15 @@ export const searchAdInterests = <ThrowOnError extends boolean = false>(options:
  *
  * - `geo`: locations, further scoped by `geoType`
  * - `interest`
+ * - `interestSuggestion`: Meta only. Interests related to the interest names in `q`, from Meta's
+ * interest suggestions. `q` lists interest names, case sensitive, names and not ids: either
+ * comma-separated (`NBA,Michael Jordan`) or, for names that contain a comma, a JSON array of
+ * strings (`["Earth, Wind & Fire","Yoga"]`, URL-encoded). A `q` starting with `[` is always read as
+ * JSON. A `q` with no name or malformed JSON returns 400 naming `q`. Meta also suggests behaviors
+ * and demographics; Zernio keeps only interests (entries whose `path` starts with `Interests`), so
+ * every id goes in `TargetingSpec.interests`, like `interest` results. Zernio asks Meta for three
+ * times `limit` (at most 100) before filtering, so fewer than `limit` results can come back. Meta
+ * weights the first name heavily: a multi-name `q` mostly returns suggestions for the first one
  * - `behavior`: Meta, TikTok and LinkedIn, matched by name; ids feed `TargetingSpec.behaviors`.
  * Meta: its fixed behaviors catalog (e.g. `Small business owners`, `Frequent Travelers`).
  * TikTok: video and creator interaction categories (e.g. `Software & Apps`), with ids like

package/src/generated/types.gen.ts

@@ -42757,6 +42757,44 @@ export type UpdateAdSetData = {
              */
             interestsBehaviors?: boolean;
         };
+        /**
+         * Meta only (400 elsewhere). Manual placements, same object and enums as `placements` on
+         * POST /v1/ads/create. Sending an object REPLACES the ad set's current placement set
+         * (`publisher_platforms`, every `*_positions` list and `device_platforms`); a position
+         * list you leave out is removed. `null` removes every placement key so Meta returns to
+         * automatic (Advantage+) placements. Omit to leave placements untouched. Meta enforces
+         * co-selection rules (e.g. a position needs its publisher platform) and its error is
+         * returned as is. Meta may also reject `null` or a narrower set when an ad's creative
+         * uses per-placement asset customization (`placementAssets`). An object with no
+         * non-empty list is a 400 (send `null` instead). Cannot be combined with
+         * `targeting.placements` (400).
+         *
+         */
+        placements?: {
+            publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network' | 'whatsapp')>;
+            facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+            instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+            messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+            audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+            threadsPositions?: Array<('threads_stream')>;
+            whatsappPositions?: Array<('status')>;
+            devicePlatforms?: Array<('mobile' | 'desktop')>;
+        } | null;
+        /**
+         * Meta only (400 elsewhere). Targeting fields to change, same shape as the `targeting`
+         * object on POST /v1/ads/create. Only the keys you send change: Zernio reads the ad set's
+         * live targeting from Meta, merges these keys over it and writes the full spec back, so
+         * everything you do not send (custom audiences, geo, age, interest groups,
+         * `targeting_automation`) is kept. Setting any location replaces every location list.
+         * An empty list or `gender: all` clears that key. `incomeTier` is resolved to Meta's
+         * income segment first (422 when Meta has none). Fields Meta cannot target (LinkedIn
+         * B2B, Google `devices`, Reddit communities and keywords) return 400 with
+         * `param: targeting.<field>`. An empty object is a 400, and so is a
+         * `targeting.placements` object with no non-empty list (`param: targeting.placements`). When the live targeting cannot be
+         * read the request returns 502 and nothing is written.
+         *
+         */
+        targeting?: (TargetingSpec);
         /**
          * Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when
          * bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's
@@ -42893,6 +42931,12 @@ export type UpdateAdSetResponse = ({
     platformSpecificData?: {
         [key: string]: unknown;
     };
+    /**
+     * Present when `placements` or `targeting` was sent. The ad set's full Meta targeting as written (Meta snake_case). The same snake_case object is stored as the ad set's and its ads' `targeting`.
+     */
+    targeting?: {
+        [key: string]: unknown;
+    };
 });
 
 export type UpdateAdSetError = (unknown | ErrorResponse);
@@ -50261,9 +50305,9 @@ export type SearchAdTargetingData = {
          */
         countryCode?: string;
         /**
-         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities (`behavior` on Meta, TikTok and LinkedIn), `interestKeyword`/`hashtag` resolve TikTok additional interests and hashtags (TikTok only), `income` resolves the normalized income tiers, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
+         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities (`behavior` on Meta, TikTok and LinkedIn), `interestSuggestion` suggests interests related to the names in `q` (Meta only), `interestKeyword`/`hashtag` resolve TikTok additional interests and hashtags (TikTok only), `income` resolves the normalized income tiers, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
          */
-        dimension?: 'geo' | 'interest' | 'interestKeyword' | 'behavior' | 'hashtag' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize' | 'community' | 'conversationKeyword';
+        dimension?: 'geo' | 'interest' | 'interestSuggestion' | 'interestKeyword' | 'behavior' | 'hashtag' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize' | 'community' | 'conversationKeyword';
         /**
          * Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
          */
@@ -50273,7 +50317,7 @@ export type SearchAdTargetingData = {
          */
         limit?: number;
         /**
-         * Search query. For geo, the locality name only (no region/country suffix).
+         * Search query. For geo, the locality name only (no region/country suffix). For `interestSuggestion`, the interest names: comma-separated, or a JSON array of strings when a name contains a comma (a `q` starting with `[` is read as JSON).
          */
         q: string;
     };
@@ -50290,7 +50334,7 @@ export type SearchAdTargetingResponse = ({
          */
         name: string;
         /**
-         * What the result is. Equals the requested dimension (interest, interestKeyword, behavior, hashtag, income, language, workPosition, workEmployer, workIndustry, industry, jobFunction, seniority, companySize, community, conversationKeyword), or the location level for geo (country, region, city, zip, metro, ...).
+         * What the result is. Equals the requested dimension (interest, interestSuggestion, interestKeyword, behavior, hashtag, income, language, workPosition, workEmployer, workIndustry, industry, jobFunction, seniority, companySize, community, conversationKeyword), or the location level for geo (country, region, city, zip, metro, ...).
          */
         type: string;
         /**