@getlatedev/node 0.2.369 → 0.2.371

package/dist/index.d.mts

@@ -10055,6 +10055,16 @@ type ConnectAdsData = {
          *
          */
         adAccountIds?: Array<(string)>;
+        /**
+         * Force a fresh OAuth even when an account already exists. Normally the
+         * endpoint returns `alreadyConnected: true` whenever a connected account
+         * is found, keying off its active state rather than token liveness.
+         * Set `force=true` to bypass that and always receivean `authUrl`.
+         * Completing the returned OAuth refreshes the stored token
+         * on the existing posting and ads accounts in place.
+         *
+         */
+        force?: boolean;
         /**
          * Enable headless mode (same-token platforms only)
          */
@@ -22504,11 +22514,15 @@ type BulkUpdateAdCampaignStatusError = (unknown | {
 });
 type DuplicateAdCampaignData = {
     body: {
-        platform: 'facebook' | 'instagram' | 'tiktok';
+        platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin';
         /**
          * Copy child ad sets + ads + creatives + targeting
          */
         deepCopy?: boolean;
+        /**
+         * ACTIVE = launch the clone immediately (spends the moment LinkedIn approves it). PAUSED = clone stays DRAFT, safe default. INHERITED_FROM_SOURCE = mirror each entity's source status per-entity. Duplicating an ACTIVE campaign this way starts a second front of spend.
+         *
+         */
         statusOption?: 'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE';
         /**
          * Reschedule the copied hierarchy's start time
@@ -23367,13 +23381,76 @@ type BoostPostData = {
              */
             endDate?: string;
         };
+        /**
+         * Same geo/demographic fields as the `TargetingSpec` used by /v1/ads/create.
+         * Geo keys (`regions`/`cities`/`zips`/`metros`) resolve via
+         * GET /v1/ads/targeting/search?dimension=geo. City radius and lat/lng
+         * `customLocations` are Meta-only and preserve the boosted post's
+         * social proof (the ad references the existing post).
+         *
+         */
         targeting?: {
             ageMin?: number;
             ageMax?: number;
+            /**
+             * Meta only.
+             */
+            gender?: 'all' | 'male' | 'female';
+            /**
+             * Meta locale ids (numeric), passed through as given.
+             */
+            languages?: Array<(string)>;
             /**
              * ISO country codes. Required for TikTok boosts (TikTok's ad group requires location_ids); optional on other platforms.
              */
             countries?: Array<(string)>;
+            /**
+             * Region/state targeting. `key` from /v1/ads/targeting/search?dimension=geo&geoType=region.
+             */
+            regions?: Array<{
+                key: string;
+                name?: string;
+            }>;
+            /**
+             * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
+             */
+            cities?: Array<{
+                key: string;
+                name?: string;
+                /**
+                 * Requires distance_unit.
+                 */
+                radius?: number;
+                distance_unit?: 'mile' | 'kilometer';
+            }>;
+            /**
+             * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
+             */
+            zips?: Array<{
+                key: string;
+                name?: string;
+            }>;
+            /**
+             * DMA / metro-area targeting. `key` is the platform's metro ID (e.g. Meta `DMA:807`).
+             */
+            metros?: Array<{
+                key: string;
+                name?: string;
+            }>;
+            /**
+             * Point-radius (lat/lng) targeting (Meta custom_locations). No geo `key` lookup needed.
+             */
+            customLocations?: Array<{
+                latitude: number;
+                longitude: number;
+                radius: number;
+                distanceUnit: 'mile' | 'kilometer';
+                name?: string;
+                /**
+                 * Optional label, sent to Meta as `address_string`.
+                 */
+                address?: string;
+            }>;
             /**
              * Interest objects from /v1/ads/interests. Each must include id and name.
              */
@@ -23386,6 +23463,17 @@ type BoostPostData = {
              */
             advantage_audience?: 0 | 1;
         };
+        /**
+         * Meta only. A verbatim Meta-native targeting spec (e.g.
+         * `{ "geo_locations": { "cities": [{ "key": "...", "radius": 15, "distance_unit": "kilometer" }] } }`),
+         * forwarded unchanged. Mutually exclusive with `targeting` (sending both is a 400).
+         * Use for advanced fields the structured object does not expose (flexible_spec,
+         * excluded audiences, business places).
+         *
+         */
+        rawTargeting?: {
+            [key: string]: unknown;
+        };
         /**
          * Meta bid strategy applied to the ad set. On TikTok, mapped to
          * `bid_type` / `bid_price` / `deep_bid_type` automatically.
@@ -23669,22 +23757,31 @@ type CreateStandaloneAdData = {
          * to build N full ads sharing one ad set: create the first ad
          * via the normal shape, then attach the rest one call each.
          *
-         * Supported on Meta (facebook, instagram) and TikTok. On TikTok
-         * the `adSetId` is the ad group ID; the new ad inherits the
-         * ad group's bid + budget + targeting.
+         * Supported on Meta (facebook, instagram), TikTok, and
+         * LinkedIn. On TikTok the `adSetId` is the ad group ID; the
+         * new ad inherits the ad group's bid + budget + targeting.
+         * On LinkedIn the `adSetId` is the LinkedIn Campaign ID
+         * (numeric); we attach a new Creative to that Campaign, so
+         * the Campaign's `platformSpecificData` bidding, targeting,
+         * budget and schedule are inherited (passing those fields
+         * returns 400).
          *
          */
         adSetId?: string;
         /**
-         * Meta only. Add the new ad set under this EXISTING campaign
-         * instead of creating a new one (multi-ad-set audience testing).
-         * The new ad set's budget is matched to the campaign's mode
-         * automatically: for a CBO campaign (campaign-level budget) omit
-         * `budgetAmount`/`budgetType` — the campaign owns the budget; for
-         * an ABO campaign pass them (they go on the new ad set). On
-         * failure only the new ad set is cleaned up; the existing campaign
-         * is left untouched and is never (re)activated. Mutually exclusive
-         * with `adSetId` and `creatives[]`.
+         * Meta + LinkedIn. On Meta: add the new ad set under this
+         * EXISTING campaign instead of creating a new one
+         * (multi-ad-set audience testing). The new ad set's budget
+         * is matched to the campaign's mode automatically: for a
+         * CBO campaign (campaign-level budget) omit
+         * `budgetAmount`/`budgetType` — the campaign owns the
+         * budget; for an ABO campaign pass them (they go on the new
+         * ad set). On LinkedIn: create a new Campaign (and its
+         * Creative) under this EXISTING CampaignGroup. On failure
+         * only the entities we authored are cleaned up; the
+         * pre-existing parent is left untouched and is never
+         * (re)activated. Mutually exclusive with `adSetId` and
+         * `creatives[]`.
          *
          */
         existingCampaignId?: string;

package/dist/index.d.ts

@@ -10055,6 +10055,16 @@ type ConnectAdsData = {
          *
          */
         adAccountIds?: Array<(string)>;
+        /**
+         * Force a fresh OAuth even when an account already exists. Normally the
+         * endpoint returns `alreadyConnected: true` whenever a connected account
+         * is found, keying off its active state rather than token liveness.
+         * Set `force=true` to bypass that and always receivean `authUrl`.
+         * Completing the returned OAuth refreshes the stored token
+         * on the existing posting and ads accounts in place.
+         *
+         */
+        force?: boolean;
         /**
          * Enable headless mode (same-token platforms only)
          */
@@ -22504,11 +22514,15 @@ type BulkUpdateAdCampaignStatusError = (unknown | {
 });
 type DuplicateAdCampaignData = {
     body: {
-        platform: 'facebook' | 'instagram' | 'tiktok';
+        platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin';
         /**
          * Copy child ad sets + ads + creatives + targeting
          */
         deepCopy?: boolean;
+        /**
+         * ACTIVE = launch the clone immediately (spends the moment LinkedIn approves it). PAUSED = clone stays DRAFT, safe default. INHERITED_FROM_SOURCE = mirror each entity's source status per-entity. Duplicating an ACTIVE campaign this way starts a second front of spend.
+         *
+         */
         statusOption?: 'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE';
         /**
          * Reschedule the copied hierarchy's start time
@@ -23367,13 +23381,76 @@ type BoostPostData = {
              */
             endDate?: string;
         };
+        /**
+         * Same geo/demographic fields as the `TargetingSpec` used by /v1/ads/create.
+         * Geo keys (`regions`/`cities`/`zips`/`metros`) resolve via
+         * GET /v1/ads/targeting/search?dimension=geo. City radius and lat/lng
+         * `customLocations` are Meta-only and preserve the boosted post's
+         * social proof (the ad references the existing post).
+         *
+         */
         targeting?: {
             ageMin?: number;
             ageMax?: number;
+            /**
+             * Meta only.
+             */
+            gender?: 'all' | 'male' | 'female';
+            /**
+             * Meta locale ids (numeric), passed through as given.
+             */
+            languages?: Array<(string)>;
             /**
              * ISO country codes. Required for TikTok boosts (TikTok's ad group requires location_ids); optional on other platforms.
              */
             countries?: Array<(string)>;
+            /**
+             * Region/state targeting. `key` from /v1/ads/targeting/search?dimension=geo&geoType=region.
+             */
+            regions?: Array<{
+                key: string;
+                name?: string;
+            }>;
+            /**
+             * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
+             */
+            cities?: Array<{
+                key: string;
+                name?: string;
+                /**
+                 * Requires distance_unit.
+                 */
+                radius?: number;
+                distance_unit?: 'mile' | 'kilometer';
+            }>;
+            /**
+             * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
+             */
+            zips?: Array<{
+                key: string;
+                name?: string;
+            }>;
+            /**
+             * DMA / metro-area targeting. `key` is the platform's metro ID (e.g. Meta `DMA:807`).
+             */
+            metros?: Array<{
+                key: string;
+                name?: string;
+            }>;
+            /**
+             * Point-radius (lat/lng) targeting (Meta custom_locations). No geo `key` lookup needed.
+             */
+            customLocations?: Array<{
+                latitude: number;
+                longitude: number;
+                radius: number;
+                distanceUnit: 'mile' | 'kilometer';
+                name?: string;
+                /**
+                 * Optional label, sent to Meta as `address_string`.
+                 */
+                address?: string;
+            }>;
             /**
              * Interest objects from /v1/ads/interests. Each must include id and name.
              */
@@ -23386,6 +23463,17 @@ type BoostPostData = {
              */
             advantage_audience?: 0 | 1;
         };
+        /**
+         * Meta only. A verbatim Meta-native targeting spec (e.g.
+         * `{ "geo_locations": { "cities": [{ "key": "...", "radius": 15, "distance_unit": "kilometer" }] } }`),
+         * forwarded unchanged. Mutually exclusive with `targeting` (sending both is a 400).
+         * Use for advanced fields the structured object does not expose (flexible_spec,
+         * excluded audiences, business places).
+         *
+         */
+        rawTargeting?: {
+            [key: string]: unknown;
+        };
         /**
          * Meta bid strategy applied to the ad set. On TikTok, mapped to
          * `bid_type` / `bid_price` / `deep_bid_type` automatically.
@@ -23669,22 +23757,31 @@ type CreateStandaloneAdData = {
          * to build N full ads sharing one ad set: create the first ad
          * via the normal shape, then attach the rest one call each.
          *
-         * Supported on Meta (facebook, instagram) and TikTok. On TikTok
-         * the `adSetId` is the ad group ID; the new ad inherits the
-         * ad group's bid + budget + targeting.
+         * Supported on Meta (facebook, instagram), TikTok, and
+         * LinkedIn. On TikTok the `adSetId` is the ad group ID; the
+         * new ad inherits the ad group's bid + budget + targeting.
+         * On LinkedIn the `adSetId` is the LinkedIn Campaign ID
+         * (numeric); we attach a new Creative to that Campaign, so
+         * the Campaign's `platformSpecificData` bidding, targeting,
+         * budget and schedule are inherited (passing those fields
+         * returns 400).
          *
          */
         adSetId?: string;
         /**
-         * Meta only. Add the new ad set under this EXISTING campaign
-         * instead of creating a new one (multi-ad-set audience testing).
-         * The new ad set's budget is matched to the campaign's mode
-         * automatically: for a CBO campaign (campaign-level budget) omit
-         * `budgetAmount`/`budgetType` — the campaign owns the budget; for
-         * an ABO campaign pass them (they go on the new ad set). On
-         * failure only the new ad set is cleaned up; the existing campaign
-         * is left untouched and is never (re)activated. Mutually exclusive
-         * with `adSetId` and `creatives[]`.
+         * Meta + LinkedIn. On Meta: add the new ad set under this
+         * EXISTING campaign instead of creating a new one
+         * (multi-ad-set audience testing). The new ad set's budget
+         * is matched to the campaign's mode automatically: for a
+         * CBO campaign (campaign-level budget) omit
+         * `budgetAmount`/`budgetType` — the campaign owns the
+         * budget; for an ABO campaign pass them (they go on the new
+         * ad set). On LinkedIn: create a new Campaign (and its
+         * Creative) under this EXISTING CampaignGroup. On failure
+         * only the entities we authored are cleaned up; the
+         * pre-existing parent is left untouched and is never
+         * (re)activated. Mutually exclusive with `adSetId` and
+         * `creatives[]`.
          *
          */
         existingCampaignId?: 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.369",
+  version: "0.2.371",
   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.369",
+  version: "0.2.371",
   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.369",
+  "version": "0.2.371",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -6257,6 +6257,17 @@ export const bulkUpdateAdCampaignStatus = <ThrowOnError extends boolean = false>
  * carrying over budget / targeting / bid_type / bid_price /
  * deep_bid_type / creative fields. Spark Ad linkage (`tiktok_item_id`)
  * is preserved.
+ * - **LinkedIn** has no native copy primitive; Zernio walks the source
+ * CampaignGroup → Campaigns → Creatives and recreates each entity,
+ * carrying over `type` / `costType` / `unitCost` /
+ * `optimizationTargetType` / `creativeSelection` / `objectiveType` /
+ * `format` / `dailyBudget` / `totalBudget` / `targetingCriteria` /
+ * `runSchedule` and every Creative's `content` object verbatim.
+ * `statusOption: INHERITED_FROM_SOURCE` is evaluated **per entity**:
+ * any Group / Campaign / Creative whose source is `ACTIVE` gets its
+ * clone activated too. Duplicating an ACTIVE campaign with
+ * `INHERITED_FROM_SOURCE` starts a second front of spend the moment
+ * the clone activates — the safe default is `PAUSED`.
  *
  * The new hierarchy is asynchronous to materialize in our DB — we
  * trigger sync discovery automatically. Set `syncAfter: false` to

package/src/generated/types.gen.ts

@@ -9658,6 +9658,16 @@ export type ConnectAdsData = {
          *
          */
         adAccountIds?: Array<(string)>;
+        /**
+         * Force a fresh OAuth even when an account already exists. Normally the
+         * endpoint returns `alreadyConnected: true` whenever a connected account
+         * is found, keying off its active state rather than token liveness.
+         * Set `force=true` to bypass that and always receivean `authUrl`.
+         * Completing the returned OAuth refreshes the stored token
+         * on the existing posting and ads accounts in place.
+         *
+         */
+        force?: boolean;
         /**
          * Enable headless mode (same-token platforms only)
          */
@@ -23106,11 +23116,15 @@ export type BulkUpdateAdCampaignStatusError = (unknown | {
 
 export type DuplicateAdCampaignData = {
     body: {
-        platform: 'facebook' | 'instagram' | 'tiktok';
+        platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin';
         /**
          * Copy child ad sets + ads + creatives + targeting
          */
         deepCopy?: boolean;
+        /**
+         * ACTIVE = launch the clone immediately (spends the moment LinkedIn approves it). PAUSED = clone stays DRAFT, safe default. INHERITED_FROM_SOURCE = mirror each entity's source status per-entity. Duplicating an ACTIVE campaign this way starts a second front of spend.
+         *
+         */
         statusOption?: 'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE';
         /**
          * Reschedule the copied hierarchy's start time
@@ -24026,13 +24040,76 @@ export type BoostPostData = {
              */
             endDate?: string;
         };
+        /**
+         * Same geo/demographic fields as the `TargetingSpec` used by /v1/ads/create.
+         * Geo keys (`regions`/`cities`/`zips`/`metros`) resolve via
+         * GET /v1/ads/targeting/search?dimension=geo. City radius and lat/lng
+         * `customLocations` are Meta-only and preserve the boosted post's
+         * social proof (the ad references the existing post).
+         *
+         */
         targeting?: {
             ageMin?: number;
             ageMax?: number;
+            /**
+             * Meta only.
+             */
+            gender?: 'all' | 'male' | 'female';
+            /**
+             * Meta locale ids (numeric), passed through as given.
+             */
+            languages?: Array<(string)>;
             /**
              * ISO country codes. Required for TikTok boosts (TikTok's ad group requires location_ids); optional on other platforms.
              */
             countries?: Array<(string)>;
+            /**
+             * Region/state targeting. `key` from /v1/ads/targeting/search?dimension=geo&geoType=region.
+             */
+            regions?: Array<{
+                key: string;
+                name?: string;
+            }>;
+            /**
+             * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
+             */
+            cities?: Array<{
+                key: string;
+                name?: string;
+                /**
+                 * Requires distance_unit.
+                 */
+                radius?: number;
+                distance_unit?: 'mile' | 'kilometer';
+            }>;
+            /**
+             * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
+             */
+            zips?: Array<{
+                key: string;
+                name?: string;
+            }>;
+            /**
+             * DMA / metro-area targeting. `key` is the platform's metro ID (e.g. Meta `DMA:807`).
+             */
+            metros?: Array<{
+                key: string;
+                name?: string;
+            }>;
+            /**
+             * Point-radius (lat/lng) targeting (Meta custom_locations). No geo `key` lookup needed.
+             */
+            customLocations?: Array<{
+                latitude: number;
+                longitude: number;
+                radius: number;
+                distanceUnit: 'mile' | 'kilometer';
+                name?: string;
+                /**
+                 * Optional label, sent to Meta as `address_string`.
+                 */
+                address?: string;
+            }>;
             /**
              * Interest objects from /v1/ads/interests. Each must include id and name.
              */
@@ -24045,6 +24122,17 @@ export type BoostPostData = {
              */
             advantage_audience?: 0 | 1;
         };
+        /**
+         * Meta only. A verbatim Meta-native targeting spec (e.g.
+         * `{ "geo_locations": { "cities": [{ "key": "...", "radius": 15, "distance_unit": "kilometer" }] } }`),
+         * forwarded unchanged. Mutually exclusive with `targeting` (sending both is a 400).
+         * Use for advanced fields the structured object does not expose (flexible_spec,
+         * excluded audiences, business places).
+         *
+         */
+        rawTargeting?: {
+            [key: string]: unknown;
+        };
         /**
          * Meta bid strategy applied to the ad set. On TikTok, mapped to
          * `bid_type` / `bid_price` / `deep_bid_type` automatically.
@@ -24331,22 +24419,31 @@ export type CreateStandaloneAdData = {
          * to build N full ads sharing one ad set: create the first ad
          * via the normal shape, then attach the rest one call each.
          *
-         * Supported on Meta (facebook, instagram) and TikTok. On TikTok
-         * the `adSetId` is the ad group ID; the new ad inherits the
-         * ad group's bid + budget + targeting.
+         * Supported on Meta (facebook, instagram), TikTok, and
+         * LinkedIn. On TikTok the `adSetId` is the ad group ID; the
+         * new ad inherits the ad group's bid + budget + targeting.
+         * On LinkedIn the `adSetId` is the LinkedIn Campaign ID
+         * (numeric); we attach a new Creative to that Campaign, so
+         * the Campaign's `platformSpecificData` bidding, targeting,
+         * budget and schedule are inherited (passing those fields
+         * returns 400).
          *
          */
         adSetId?: string;
         /**
-         * Meta only. Add the new ad set under this EXISTING campaign
-         * instead of creating a new one (multi-ad-set audience testing).
-         * The new ad set's budget is matched to the campaign's mode
-         * automatically: for a CBO campaign (campaign-level budget) omit
-         * `budgetAmount`/`budgetType` — the campaign owns the budget; for
-         * an ABO campaign pass them (they go on the new ad set). On
-         * failure only the new ad set is cleaned up; the existing campaign
-         * is left untouched and is never (re)activated. Mutually exclusive
-         * with `adSetId` and `creatives[]`.
+         * Meta + LinkedIn. On Meta: add the new ad set under this
+         * EXISTING campaign instead of creating a new one
+         * (multi-ad-set audience testing). The new ad set's budget
+         * is matched to the campaign's mode automatically: for a
+         * CBO campaign (campaign-level budget) omit
+         * `budgetAmount`/`budgetType` — the campaign owns the
+         * budget; for an ABO campaign pass them (they go on the new
+         * ad set). On LinkedIn: create a new Campaign (and its
+         * Creative) under this EXISTING CampaignGroup. On failure
+         * only the entities we authored are cleaned up; the
+         * pre-existing parent is left untouched and is never
+         * (re)activated. Mutually exclusive with `adSetId` and
+         * `creatives[]`.
          *
          */
         existingCampaignId?: string;