@zernio/node 0.2.754 → 0.2.756

package/dist/index.d.mts

@@ -8245,19 +8245,19 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * LinkedIn B2B only. Industry URN id fragments.
+     * LinkedIn B2B only. Industry URN id fragments, or the full urn:li:industry:* URN from /v1/ads/targeting/search?dimension=industry.
      */
     industries?: Array<(string)>;
     /**
-     * LinkedIn B2B only.
+     * LinkedIn B2B only. Single-letter size codes (A to I), or the full urn:li:staffCountRange:* URN from /v1/ads/targeting/search?dimension=companySize.
      */
     companySizes?: Array<(string)>;
     /**
-     * LinkedIn B2B only.
+     * LinkedIn B2B only. Seniority URN id fragments, or the full urn:li:seniority:* URN from /v1/ads/targeting/search?dimension=seniority.
      */
     seniorities?: Array<(string)>;
     /**
-     * LinkedIn B2B only.
+     * LinkedIn B2B only. Function URN id fragments, or the full urn:li:function:* URN from /v1/ads/targeting/search?dimension=jobFunction.
      */
     jobFunctions?: Array<(string)>;
     /**
@@ -33433,7 +33433,36 @@ type UpdateAdData = {
             })>;
             ageMin?: number;
             ageMax?: number;
+            /**
+             * ISO 3166-1 alpha-2 codes. On Google this is the FULL new country set for the campaign (same contract as `locations`); on LinkedIn it replaces the campaign's geo criteria.
+             */
             countries?: Array<(string)>;
+            /**
+             * Google and LinkedIn. The FULL new location set for the campaign. Bare country-code array, or an object with countries/regions/cities/zips/metros key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Equivalent to the top-level geo fields; sending both returns 400. Empty returns 400, `customLocations` returns 422.
+             */
+            locations?: (Array<(string)> | {
+                countries?: Array<(string)>;
+                regions?: Array<{
+                    key: string;
+                    name?: string;
+                }>;
+                cities?: Array<{
+                    key: string;
+                    name?: string;
+                }>;
+                zips?: Array<{
+                    key: string;
+                    name?: string;
+                }>;
+                metros?: Array<{
+                    key: string;
+                    name?: string;
+                }>;
+            });
+            /**
+             * Google only. The FULL new language set for the campaign, as Google language codes (ISO 639-1, plus variants such as `zh_CN`). An unknown code returns 400.
+             */
+            languages?: Array<(string)>;
             /**
              * Interest objects from /v1/ads/interests. Each must include id and name.
              */
@@ -38310,9 +38339,9 @@ type SearchAdTargetingData = {
          */
         countryCode?: string;
         /**
-         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics. 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, `income` resolves income-tier options, `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' | 'behavior' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry';
+        dimension?: 'geo' | 'interest' | 'behavior' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize';
         /**
          * Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
          */
@@ -38338,7 +38367,7 @@ type SearchAdTargetingResponse = ({
          */
         name: string;
         /**
-         * What the result is (e.g. city, region, country, zip, metro, location, interest, behavior, income).
+         * What the result is (e.g. city, region, country, zip, metro, location, interest, behavior, income, industry, jobFunction, seniority, companySize).
          */
         type: string;
         /**

package/dist/index.d.ts

@@ -8245,19 +8245,19 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * LinkedIn B2B only. Industry URN id fragments.
+     * LinkedIn B2B only. Industry URN id fragments, or the full urn:li:industry:* URN from /v1/ads/targeting/search?dimension=industry.
      */
     industries?: Array<(string)>;
     /**
-     * LinkedIn B2B only.
+     * LinkedIn B2B only. Single-letter size codes (A to I), or the full urn:li:staffCountRange:* URN from /v1/ads/targeting/search?dimension=companySize.
      */
     companySizes?: Array<(string)>;
     /**
-     * LinkedIn B2B only.
+     * LinkedIn B2B only. Seniority URN id fragments, or the full urn:li:seniority:* URN from /v1/ads/targeting/search?dimension=seniority.
      */
     seniorities?: Array<(string)>;
     /**
-     * LinkedIn B2B only.
+     * LinkedIn B2B only. Function URN id fragments, or the full urn:li:function:* URN from /v1/ads/targeting/search?dimension=jobFunction.
      */
     jobFunctions?: Array<(string)>;
     /**
@@ -33433,7 +33433,36 @@ type UpdateAdData = {
             })>;
             ageMin?: number;
             ageMax?: number;
+            /**
+             * ISO 3166-1 alpha-2 codes. On Google this is the FULL new country set for the campaign (same contract as `locations`); on LinkedIn it replaces the campaign's geo criteria.
+             */
             countries?: Array<(string)>;
+            /**
+             * Google and LinkedIn. The FULL new location set for the campaign. Bare country-code array, or an object with countries/regions/cities/zips/metros key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Equivalent to the top-level geo fields; sending both returns 400. Empty returns 400, `customLocations` returns 422.
+             */
+            locations?: (Array<(string)> | {
+                countries?: Array<(string)>;
+                regions?: Array<{
+                    key: string;
+                    name?: string;
+                }>;
+                cities?: Array<{
+                    key: string;
+                    name?: string;
+                }>;
+                zips?: Array<{
+                    key: string;
+                    name?: string;
+                }>;
+                metros?: Array<{
+                    key: string;
+                    name?: string;
+                }>;
+            });
+            /**
+             * Google only. The FULL new language set for the campaign, as Google language codes (ISO 639-1, plus variants such as `zh_CN`). An unknown code returns 400.
+             */
+            languages?: Array<(string)>;
             /**
              * Interest objects from /v1/ads/interests. Each must include id and name.
              */
@@ -38310,9 +38339,9 @@ type SearchAdTargetingData = {
          */
         countryCode?: string;
         /**
-         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics. 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, `income` resolves income-tier options, `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' | 'behavior' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry';
+        dimension?: 'geo' | 'interest' | 'behavior' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize';
         /**
          * Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
          */
@@ -38338,7 +38367,7 @@ type SearchAdTargetingResponse = ({
          */
         name: string;
         /**
-         * What the result is (e.g. city, region, country, zip, metro, location, interest, behavior, income).
+         * What the result is (e.g. city, region, country, zip, metro, location, interest, behavior, income, industry, jobFunction, seniority, companySize).
          */
         type: string;
         /**

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -8370,7 +8370,12 @@ export const getCampaignTargeting = <ThrowOnError extends boolean = false>(optio
  * `locations` accepts the same shapes as campaign creation: a bare array of
  * ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros`
  * key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative
- * (excluded) locations are left untouched by this endpoint.
+ * (excluded) locations are left untouched by this endpoint. An empty location list
+ * returns 400 instead of removing every criterion: a Google campaign with no location
+ * criteria targets every country, so omit `locations` to leave targeting alone.
+ *
+ * The removes and the creates go out in ONE Google `googleAds:mutate`, so a failed
+ * edit leaves the campaign's previous set intact rather than a half-applied one.
  *
  * `languages` is an array of Google's language codes (ISO 639-1, plus variants
  * such as `zh_CN`); an unknown code returns 400.
@@ -8663,10 +8668,13 @@ export const getAd = <ThrowOnError extends boolean = false>(options: OptionsLega
  * - **TikTok**: status, budget, targeting (via `/v2/adgroup/update/`), and creative
  * (via `/v2/ad/update/` patch-style: `headline` is ignored, `body` becomes `ad_text`).
  * - **Google**: status, budget, KEYWORD edits via `targeting.keywords` /
- * `targeting.negativeKeywords`, and DEVICE bid adjustments via `targeting.devices`.
+ * `targeting.negativeKeywords`, DEVICE bid adjustments via `targeting.devices`,
+ * LOCATION edits via `targeting.locations` (or the equivalent top-level
+ * `targeting.countries` / `regions` / `cities` / `zips` / `metros`), and LANGUAGE
+ * edits via `targeting.languages`.
  * Each list you send becomes the FULL new set of its kind (criteria not in the
  * list are removed); a kind left out is untouched. Any other `targeting` field
- * returns 400: Google cannot mutate broad targeting post-create without recreating
+ * returns 400: Google cannot mutate it post-create without recreating
  * the campaign. RSA text updates use top-level `headlines`, `descriptions` and `finalUrls`.
  * Each supplied array replaces the full list; omit a field to preserve it. Use 3-15 headlines
  * (1-30 characters) and 2-4 descriptions (1-90 characters). Omit an asset to remove it;
@@ -8681,6 +8689,19 @@ export const getAd = <ThrowOnError extends boolean = false>(options: OptionsLega
  * `targeting` or `creative` returns 501 with code `unsupported_platform_operation`.
  * OpenAI Ads budget is lifetime-only (see `budget.type` below).
  *
+ * **Google location and language replacement:** locations, languages and devices are
+ * campaign-level criteria on Google, so these edits apply to every ad group and ad in
+ * the ad's campaign. Send the complete list you want to keep. Zernio diffs it against
+ * the campaign's live criteria and sends the removes and the creates in ONE
+ * `googleAds:mutate`, so the campaign is never left with a half-applied set; criteria
+ * already in the list keep their criterion ID and history. Excluded (negative)
+ * locations are left untouched. Two cases are refused rather than applied: an empty
+ * location list returns 400 (a Google campaign with no location criteria targets every
+ * country, which is never what "remove my locations" means, so omit the field instead),
+ * and radius targeting (`customLocations`) returns 422 because it is a separate Google
+ * criterion type that this replacement neither creates nor removes. Send either
+ * `targeting.locations` or the top-level geo fields, not both: mixing them returns 400.
+ *
  * **Google keyword replacement:** These edits affect the ad's entire ad group,
  * including sibling ads. Positive (`targeting.keywords`) and negative
  * (`targeting.negativeKeywords`) sets are independent: omit a field to leave
@@ -10236,6 +10257,8 @@ export const searchAdInterests = <ThrowOnError extends boolean = false>(options:
  * - `language`: Google-only
  * - `workPosition`, `workEmployer`, `workIndustry`: the Meta-only work demographics, whose
  * ids feed `TargetingSpec.workPositions`/`workEmployers`/`workIndustries`
+ * - `industry`, `jobFunction`, `seniority`, `companySize`: the LinkedIn-only B2B facets, whose
+ * URNs feed `TargetingSpec.industries`/`jobFunctions`/`seniorities`/`companySizes`
  *
  * Availability of each dimension varies by platform (e.g. behaviours are Meta/TikTok only).
  * Work industries are a fixed ~30-entry Meta catalog with no server-side query,
@@ -10260,6 +10283,15 @@ export const searchAdInterests = <ThrowOnError extends boolean = false>(options:
  * `urn:li:geo:*` URN usable as a `regions[].key` on `POST /v1/ads/create`,
  * `POST /v1/ads/boost` and `POST /v1/ads/targeting/reach-estimate`.
  *
+ * LinkedIn B2B searches (`industry`, `jobFunction`, `seniority`, `companySize`) return the
+ * full URN to pass straight back, so no URN id fragment has to be assembled by hand:
+ * `urn:li:industry:4`, `urn:li:function:8`, `urn:li:seniority:6`,
+ * `urn:li:staffCountRange:(51,200)`. Only `industry` is a server-side name search
+ * (LinkedIn's typeahead finder). LinkedIn exposes no typeahead for job functions,
+ * seniorities and company sizes, so Zernio fetches each whole table (26, 10 and 9 entries),
+ * caches it, and does the matching, ranking and `limit` cutoff itself. Those three never
+ * carry `audienceSize`, and `countryCode` and `geoType` are not applied to any of the four.
+ *
  * Google geo searches resolve against Google's geoTargetConstants and return
  * every matching level in one list; `geoType` is not applied (Google's
  * `target_type` is an open taxonomy that does not map one-to-one onto the

package/src/generated/types.gen.ts

@@ -6938,19 +6938,19 @@ export type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * LinkedIn B2B only. Industry URN id fragments.
+     * LinkedIn B2B only. Industry URN id fragments, or the full urn:li:industry:* URN from /v1/ads/targeting/search?dimension=industry.
      */
     industries?: Array<(string)>;
     /**
-     * LinkedIn B2B only.
+     * LinkedIn B2B only. Single-letter size codes (A to I), or the full urn:li:staffCountRange:* URN from /v1/ads/targeting/search?dimension=companySize.
      */
     companySizes?: Array<(string)>;
     /**
-     * LinkedIn B2B only.
+     * LinkedIn B2B only. Seniority URN id fragments, or the full urn:li:seniority:* URN from /v1/ads/targeting/search?dimension=seniority.
      */
     seniorities?: Array<(string)>;
     /**
-     * LinkedIn B2B only.
+     * LinkedIn B2B only. Function URN id fragments, or the full urn:li:function:* URN from /v1/ads/targeting/search?dimension=jobFunction.
      */
     jobFunctions?: Array<(string)>;
     /**
@@ -33805,7 +33805,36 @@ export type UpdateAdData = {
 })>;
             ageMin?: number;
             ageMax?: number;
+            /**
+             * ISO 3166-1 alpha-2 codes. On Google this is the FULL new country set for the campaign (same contract as `locations`); on LinkedIn it replaces the campaign's geo criteria.
+             */
             countries?: Array<(string)>;
+            /**
+             * Google and LinkedIn. The FULL new location set for the campaign. Bare country-code array, or an object with countries/regions/cities/zips/metros key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Equivalent to the top-level geo fields; sending both returns 400. Empty returns 400, `customLocations` returns 422.
+             */
+            locations?: (Array<(string)> | {
+    countries?: Array<(string)>;
+    regions?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    cities?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    zips?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    metros?: Array<{
+        key: string;
+        name?: string;
+    }>;
+});
+            /**
+             * Google only. The FULL new language set for the campaign, as Google language codes (ISO 639-1, plus variants such as `zh_CN`). An unknown code returns 400.
+             */
+            languages?: Array<(string)>;
             /**
              * Interest objects from /v1/ads/interests. Each must include id and name.
              */
@@ -38961,9 +38990,9 @@ export type SearchAdTargetingData = {
          */
         countryCode?: string;
         /**
-         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics. 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, `income` resolves income-tier options, `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' | 'behavior' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry';
+        dimension?: 'geo' | 'interest' | 'behavior' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize';
         /**
          * Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
          */
@@ -38990,7 +39019,7 @@ export type SearchAdTargetingResponse = ({
          */
         name: string;
         /**
-         * What the result is (e.g. city, region, country, zip, metro, location, interest, behavior, income).
+         * What the result is (e.g. city, region, country, zip, metro, location, interest, behavior, income, industry, jobFunction, seniority, companySize).
          */
         type: string;
         /**