@zernio/node 0.2.753 → 0.2.755

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)>;
     /**
@@ -32983,7 +32983,7 @@ type GetAdSetDetailsData = {
          */
         accountId: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
     };
@@ -34772,7 +34772,7 @@ type ListAdStudiesData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -35090,7 +35090,7 @@ type ListAdCreativesData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -35193,7 +35193,7 @@ type GetAdCreativeData = {
          */
         accountId: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
     };
@@ -38148,7 +38148,7 @@ type ListAdImagesData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -38227,7 +38227,7 @@ type ListAdVideosData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -38310,9 +38310,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 +38338,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;
         /**
@@ -38377,7 +38377,7 @@ type SearchAdLibraryData = {
          */
         countries?: string;
         /**
-         * Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads.
+         * Meta only. Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: 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)>;
     /**
@@ -32983,7 +32983,7 @@ type GetAdSetDetailsData = {
          */
         accountId: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
     };
@@ -34772,7 +34772,7 @@ type ListAdStudiesData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -35090,7 +35090,7 @@ type ListAdCreativesData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -35193,7 +35193,7 @@ type GetAdCreativeData = {
          */
         accountId: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
     };
@@ -38148,7 +38148,7 @@ type ListAdImagesData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -38227,7 +38227,7 @@ type ListAdVideosData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -38310,9 +38310,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 +38338,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;
         /**
@@ -38377,7 +38377,7 @@ type SearchAdLibraryData = {
          */
         countries?: string;
         /**
-         * Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads.
+         * Meta only. Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: 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.753",
+  version: "0.2.755",
   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.753",
+  version: "0.2.755",
   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.753",
+  "version": "0.2.755",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -10236,6 +10236,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 +10262,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)>;
     /**
@@ -33334,7 +33334,7 @@ export type GetAdSetDetailsData = {
          */
         accountId: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
     };
@@ -35243,7 +35243,7 @@ export type ListAdStudiesData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -35585,7 +35585,7 @@ export type ListAdCreativesData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -35694,7 +35694,7 @@ export type GetAdCreativeData = {
          */
         accountId: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
     };
@@ -38784,7 +38784,7 @@ export type ListAdImagesData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -38869,7 +38869,7 @@ export type ListAdVideosData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph field override (supports nested {} projections).
+         * Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**
@@ -38961,9 +38961,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 +38990,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;
         /**
@@ -39031,7 +39031,7 @@ export type SearchAdLibraryData = {
          */
         countries?: string;
         /**
-         * Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads.
+         * Meta only. Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
          */
         fields?: string;
         /**