@getlatedev/node 0.2.1216 → 0.2.1218

package/dist/index.d.mts

@@ -12342,6 +12342,22 @@ type SocialAccount = {
      *
      */
     enabled?: boolean;
+    /**
+     * End of the account's publishing cooldown. Compare it with the current time: a value
+     * in the past means the cooldown has ended (the field is cleared on the next successful
+     * publish), null means no cooldown since the last successful publish. A cooldown starts
+     * when a post to the account fails with `errorCategory` `user_abuse` (spam, abuse or
+     * rate-limit errors), or when 10 or more posts to it fail within an hour with
+     * `user_content`, `platform_error`, `platform_rate_limit` or `unknown`. It doubles with
+     * each start inside a 24-hour window that opens at the first one (10, 20, 40, 80 minutes
+     * and so on, capped at 24 hours). On a YouTube account with a recorded successful upload
+     * it instead runs until 24 hours after that upload, or 1 hour when that upload is older
+     * than 24 hours. While it is in the future, POST /v1/posts (drafts excepted) and
+     * POST /v1/posts/{postId}/retry return 429 for this account, and this account's pending
+     * targets on posts scheduled before the cooldown ends are failed when it starts.
+     *
+     */
+    rateLimitedUntil?: (string) | null;
     /**
      * Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes:
      * - qualityRating: Phone number quality rating from Meta (GREEN, YELLOW, RED, or UNKNOWN)
@@ -49379,9 +49395,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`.
          */
@@ -49391,7 +49407,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;
     };
@@ -49407,7 +49423,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

@@ -12342,6 +12342,22 @@ type SocialAccount = {
      *
      */
     enabled?: boolean;
+    /**
+     * End of the account's publishing cooldown. Compare it with the current time: a value
+     * in the past means the cooldown has ended (the field is cleared on the next successful
+     * publish), null means no cooldown since the last successful publish. A cooldown starts
+     * when a post to the account fails with `errorCategory` `user_abuse` (spam, abuse or
+     * rate-limit errors), or when 10 or more posts to it fail within an hour with
+     * `user_content`, `platform_error`, `platform_rate_limit` or `unknown`. It doubles with
+     * each start inside a 24-hour window that opens at the first one (10, 20, 40, 80 minutes
+     * and so on, capped at 24 hours). On a YouTube account with a recorded successful upload
+     * it instead runs until 24 hours after that upload, or 1 hour when that upload is older
+     * than 24 hours. While it is in the future, POST /v1/posts (drafts excepted) and
+     * POST /v1/posts/{postId}/retry return 429 for this account, and this account's pending
+     * targets on posts scheduled before the cooldown ends are failed when it starts.
+     *
+     */
+    rateLimitedUntil?: (string) | null;
     /**
      * Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes:
      * - qualityRating: Phone number quality rating from Meta (GREEN, YELLOW, RED, or UNKNOWN)
@@ -49379,9 +49395,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`.
          */
@@ -49391,7 +49407,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;
     };
@@ -49407,7 +49423,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.1216",
+  version: "0.2.1218",
   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.1216",
+  version: "0.2.1218",
   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.1216",
+  "version": "0.2.1218",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -13166,6 +13166,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

@@ -10799,6 +10799,22 @@ export type SocialAccount = {
      *
      */
     enabled?: boolean;
+    /**
+     * End of the account's publishing cooldown. Compare it with the current time: a value
+     * in the past means the cooldown has ended (the field is cleared on the next successful
+     * publish), null means no cooldown since the last successful publish. A cooldown starts
+     * when a post to the account fails with `errorCategory` `user_abuse` (spam, abuse or
+     * rate-limit errors), or when 10 or more posts to it fail within an hour with
+     * `user_content`, `platform_error`, `platform_rate_limit` or `unknown`. It doubles with
+     * each start inside a 24-hour window that opens at the first one (10, 20, 40, 80 minutes
+     * and so on, capped at 24 hours). On a YouTube account with a recorded successful upload
+     * it instead runs until 24 hours after that upload, or 1 hour when that upload is older
+     * than 24 hours. While it is in the future, POST /v1/posts (drafts excepted) and
+     * POST /v1/posts/{postId}/retry return 429 for this account, and this account's pending
+     * targets on posts scheduled before the cooldown ends are failed when it starts.
+     *
+     */
+    rateLimitedUntil?: (string) | null;
     /**
      * Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes:
      * - qualityRating: Phone number quality rating from Meta (GREEN, YELLOW, RED, or UNKNOWN)
@@ -50245,9 +50261,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`.
          */
@@ -50257,7 +50273,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;
     };
@@ -50274,7 +50290,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;
         /**