@getlatedev/node 0.2.275 → 0.2.277

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -19120,6 +19120,17 @@ type BoostPostData = {
19120
19120
  *
19121
19121
  */
19122
19122
  roasAverageFloor?: number;
19123
+ /**
19124
+ * Meta only. A raw Meta-native targeting spec passed to the ad set VERBATIM (snake_case:
19125
+ * `geo_locations`, `custom_audiences`, `excluded_custom_audiences`, `flexible_spec`,
19126
+ * `targeting_automation`, etc.). Use it to target specific custom or lookalike audiences,
19127
+ * or to clone a campaign's targeting exactly. Mutually exclusive with `targeting` (sending
19128
+ * both → 422). Sent as-is; Meta validates and surfaces any errors.
19129
+ *
19130
+ */
19131
+ rawTargeting?: {
19132
+ [key: string]: unknown;
19133
+ };
19123
19134
  /**
19124
19135
  * Meta only. Tracking specs (pixel, URL tags).
19125
19136
  */
@@ -19485,6 +19496,36 @@ type CreateStandaloneAdData = {
19485
19496
  name?: string;
19486
19497
  address?: string;
19487
19498
  }>;
19499
+ /**
19500
+ * Named points of interest (businesses, landmarks). Meta only. `key` from /v1/ads/targeting/search?dimension=geo&geoType=place. Maps to geo_locations.places.
19501
+ */
19502
+ places?: Array<{
19503
+ key: string;
19504
+ }>;
19505
+ /**
19506
+ * Named neighbourhood areas. Meta only. `key` from /v1/ads/targeting/search?dimension=geo&geoType=neighborhood. Maps to geo_locations.neighborhoods.
19507
+ */
19508
+ neighborhoods?: Array<{
19509
+ key: string;
19510
+ }>;
19511
+ /**
19512
+ * Geo exclusions. Meta only. Maps to excluded_geo_locations. Supports countries, regions, cities, and zips.
19513
+ */
19514
+ excludedLocations?: {
19515
+ /**
19516
+ * ISO-3166 alpha-2 country codes to exclude.
19517
+ */
19518
+ countries?: Array<(string)>;
19519
+ regions?: Array<{
19520
+ key: string;
19521
+ }>;
19522
+ cities?: Array<{
19523
+ key: string;
19524
+ }>;
19525
+ zips?: Array<{
19526
+ key: string;
19527
+ }>;
19528
+ };
19488
19529
  /**
19489
19530
  * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok. Each must include id.
19490
19531
  */
@@ -20022,7 +20063,51 @@ type CreateLeadFormData = {
20022
20063
  thankYouButtonText?: string;
20023
20064
  thankYouButtonType?: string;
20024
20065
  thankYouWebsiteUrl?: string;
20066
+ /**
20067
+ * Legacy form type toggle. Prefer formType instead. false = More Volume, true = Higher Intent.
20068
+ */
20025
20069
  isOptimizedForQuality?: boolean;
20070
+ /**
20071
+ * Form type. MORE_VOLUME = optimized for lead quantity (default). HIGHER_INTENT = adds a review/confirmation step before submit. RICH_CREATIVE = includes context card and custom headline to educate users before they submit. Supersedes isOptimizedForQuality.
20072
+ */
20073
+ formType?: 'MORE_VOLUME' | 'HIGHER_INTENT' | 'RICH_CREATIVE';
20074
+ /**
20075
+ * Sharing setting. true = Restricted (only people targeted by the ad can open the form link). false = Open (shareable link, default).
20076
+ */
20077
+ blockDisplayForNonTargetedViewer?: boolean;
20078
+ /**
20079
+ * Flexible form delivery. true = the form can surface organically on the Page (not just as a paid ad). Defaults to false.
20080
+ */
20081
+ allowOrganicLeadGen?: boolean;
20082
+ /**
20083
+ * Custom subheadline shown above the form fields on the questions page (the contact-information section description). Defaults to Meta's generic copy when omitted.
20084
+ */
20085
+ questionPageCustomHeadline?: string;
20086
+ /**
20087
+ * Intro card shown before the questions page. Omit to skip the intro screen.
20088
+ */
20089
+ contextCard?: {
20090
+ /**
20091
+ * Headline / title of the intro card.
20092
+ */
20093
+ title?: string;
20094
+ /**
20095
+ * Body text lines shown on the intro card.
20096
+ */
20097
+ content?: Array<(string)>;
20098
+ /**
20099
+ * Visual layout of the intro card.
20100
+ */
20101
+ style?: 'LIST_STYLE' | 'PARAGRAPH_STYLE';
20102
+ /**
20103
+ * CTA button label on the intro card.
20104
+ */
20105
+ buttonText?: string;
20106
+ /**
20107
+ * Image hash of the cover photo (obtain from the Meta Ad Images API). Omit to show no image.
20108
+ */
20109
+ coverPhoto?: string;
20110
+ };
20026
20111
  };
20027
20112
  };
20028
20113
  type CreateLeadFormResponse = ({
@@ -20201,9 +20286,9 @@ type SearchAdTargetingData = {
20201
20286
  */
20202
20287
  dimension?: 'geo' | 'interest' | 'behavior' | 'income';
20203
20288
  /**
20204
- * Only used when `dimension=geo`. The kind of location to resolve. `place` resolves named points of interest (businesses, landmarks) by proximity. `neighborhood` resolves named neighbourhood areas. Defaults to `city`.
20289
+ * Only used when `dimension=geo`. The kind of location to resolve. `place` resolves named points of interest (businesses, landmarks). `neighborhood` resolves named neighbourhood areas. Use `all` to search every geo type in a single relevance-ranked call — mirrors Meta's own unified search box. Defaults to `city`.
20205
20290
  */
20206
- geoType?: 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
20291
+ geoType?: 'all' | 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
20207
20292
  /**
20208
20293
  * Maximum results to return.
20209
20294
  */
@@ -20236,6 +20321,14 @@ type SearchAdTargetingResponse = ({
20236
20321
  * Optional estimated reachable users for this option, when the platform returns it.
20237
20322
  */
20238
20323
  audienceSize?: (number) | null;
20324
+ /**
20325
+ * Centre latitude of the location. Populated on Meta geo results (city, neighborhood, place, etc.). Useful for map views.
20326
+ */
20327
+ latitude?: (number) | null;
20328
+ /**
20329
+ * Centre longitude of the location.
20330
+ */
20331
+ longitude?: (number) | null;
20239
20332
  }>;
20240
20333
  });
20241
20334
  type SearchAdTargetingError = (unknown | {
package/dist/index.d.ts CHANGED
@@ -19120,6 +19120,17 @@ type BoostPostData = {
19120
19120
  *
19121
19121
  */
19122
19122
  roasAverageFloor?: number;
19123
+ /**
19124
+ * Meta only. A raw Meta-native targeting spec passed to the ad set VERBATIM (snake_case:
19125
+ * `geo_locations`, `custom_audiences`, `excluded_custom_audiences`, `flexible_spec`,
19126
+ * `targeting_automation`, etc.). Use it to target specific custom or lookalike audiences,
19127
+ * or to clone a campaign's targeting exactly. Mutually exclusive with `targeting` (sending
19128
+ * both → 422). Sent as-is; Meta validates and surfaces any errors.
19129
+ *
19130
+ */
19131
+ rawTargeting?: {
19132
+ [key: string]: unknown;
19133
+ };
19123
19134
  /**
19124
19135
  * Meta only. Tracking specs (pixel, URL tags).
19125
19136
  */
@@ -19485,6 +19496,36 @@ type CreateStandaloneAdData = {
19485
19496
  name?: string;
19486
19497
  address?: string;
19487
19498
  }>;
19499
+ /**
19500
+ * Named points of interest (businesses, landmarks). Meta only. `key` from /v1/ads/targeting/search?dimension=geo&geoType=place. Maps to geo_locations.places.
19501
+ */
19502
+ places?: Array<{
19503
+ key: string;
19504
+ }>;
19505
+ /**
19506
+ * Named neighbourhood areas. Meta only. `key` from /v1/ads/targeting/search?dimension=geo&geoType=neighborhood. Maps to geo_locations.neighborhoods.
19507
+ */
19508
+ neighborhoods?: Array<{
19509
+ key: string;
19510
+ }>;
19511
+ /**
19512
+ * Geo exclusions. Meta only. Maps to excluded_geo_locations. Supports countries, regions, cities, and zips.
19513
+ */
19514
+ excludedLocations?: {
19515
+ /**
19516
+ * ISO-3166 alpha-2 country codes to exclude.
19517
+ */
19518
+ countries?: Array<(string)>;
19519
+ regions?: Array<{
19520
+ key: string;
19521
+ }>;
19522
+ cities?: Array<{
19523
+ key: string;
19524
+ }>;
19525
+ zips?: Array<{
19526
+ key: string;
19527
+ }>;
19528
+ };
19488
19529
  /**
19489
19530
  * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok. Each must include id.
19490
19531
  */
@@ -20022,7 +20063,51 @@ type CreateLeadFormData = {
20022
20063
  thankYouButtonText?: string;
20023
20064
  thankYouButtonType?: string;
20024
20065
  thankYouWebsiteUrl?: string;
20066
+ /**
20067
+ * Legacy form type toggle. Prefer formType instead. false = More Volume, true = Higher Intent.
20068
+ */
20025
20069
  isOptimizedForQuality?: boolean;
20070
+ /**
20071
+ * Form type. MORE_VOLUME = optimized for lead quantity (default). HIGHER_INTENT = adds a review/confirmation step before submit. RICH_CREATIVE = includes context card and custom headline to educate users before they submit. Supersedes isOptimizedForQuality.
20072
+ */
20073
+ formType?: 'MORE_VOLUME' | 'HIGHER_INTENT' | 'RICH_CREATIVE';
20074
+ /**
20075
+ * Sharing setting. true = Restricted (only people targeted by the ad can open the form link). false = Open (shareable link, default).
20076
+ */
20077
+ blockDisplayForNonTargetedViewer?: boolean;
20078
+ /**
20079
+ * Flexible form delivery. true = the form can surface organically on the Page (not just as a paid ad). Defaults to false.
20080
+ */
20081
+ allowOrganicLeadGen?: boolean;
20082
+ /**
20083
+ * Custom subheadline shown above the form fields on the questions page (the contact-information section description). Defaults to Meta's generic copy when omitted.
20084
+ */
20085
+ questionPageCustomHeadline?: string;
20086
+ /**
20087
+ * Intro card shown before the questions page. Omit to skip the intro screen.
20088
+ */
20089
+ contextCard?: {
20090
+ /**
20091
+ * Headline / title of the intro card.
20092
+ */
20093
+ title?: string;
20094
+ /**
20095
+ * Body text lines shown on the intro card.
20096
+ */
20097
+ content?: Array<(string)>;
20098
+ /**
20099
+ * Visual layout of the intro card.
20100
+ */
20101
+ style?: 'LIST_STYLE' | 'PARAGRAPH_STYLE';
20102
+ /**
20103
+ * CTA button label on the intro card.
20104
+ */
20105
+ buttonText?: string;
20106
+ /**
20107
+ * Image hash of the cover photo (obtain from the Meta Ad Images API). Omit to show no image.
20108
+ */
20109
+ coverPhoto?: string;
20110
+ };
20026
20111
  };
20027
20112
  };
20028
20113
  type CreateLeadFormResponse = ({
@@ -20201,9 +20286,9 @@ type SearchAdTargetingData = {
20201
20286
  */
20202
20287
  dimension?: 'geo' | 'interest' | 'behavior' | 'income';
20203
20288
  /**
20204
- * Only used when `dimension=geo`. The kind of location to resolve. `place` resolves named points of interest (businesses, landmarks) by proximity. `neighborhood` resolves named neighbourhood areas. Defaults to `city`.
20289
+ * Only used when `dimension=geo`. The kind of location to resolve. `place` resolves named points of interest (businesses, landmarks). `neighborhood` resolves named neighbourhood areas. Use `all` to search every geo type in a single relevance-ranked call — mirrors Meta's own unified search box. Defaults to `city`.
20205
20290
  */
20206
- geoType?: 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
20291
+ geoType?: 'all' | 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
20207
20292
  /**
20208
20293
  * Maximum results to return.
20209
20294
  */
@@ -20236,6 +20321,14 @@ type SearchAdTargetingResponse = ({
20236
20321
  * Optional estimated reachable users for this option, when the platform returns it.
20237
20322
  */
20238
20323
  audienceSize?: (number) | null;
20324
+ /**
20325
+ * Centre latitude of the location. Populated on Meta geo results (city, neighborhood, place, etc.). Useful for map views.
20326
+ */
20327
+ latitude?: (number) | null;
20328
+ /**
20329
+ * Centre longitude of the location.
20330
+ */
20331
+ longitude?: (number) | null;
20239
20332
  }>;
20240
20333
  });
20241
20334
  type SearchAdTargetingError = (unknown | {
package/dist/index.js CHANGED
@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
36
36
  // package.json
37
37
  var package_default = {
38
38
  name: "@getlatedev/node",
39
- version: "0.2.275",
39
+ version: "0.2.277",
40
40
  description: "The official Node.js library for the Zernio API",
41
41
  main: "dist/index.js",
42
42
  module: "dist/index.mjs",
package/dist/index.mjs CHANGED
@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
5
5
  // package.json
6
6
  var package_default = {
7
7
  name: "@getlatedev/node",
8
- version: "0.2.275",
8
+ version: "0.2.277",
9
9
  description: "The official Node.js library for the Zernio API",
10
10
  main: "dist/index.js",
11
11
  module: "dist/index.mjs",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getlatedev/node",
3
- "version": "0.2.275",
3
+ "version": "0.2.277",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -19619,6 +19619,17 @@ export type BoostPostData = {
19619
19619
  *
19620
19620
  */
19621
19621
  roasAverageFloor?: number;
19622
+ /**
19623
+ * Meta only. A raw Meta-native targeting spec passed to the ad set VERBATIM (snake_case:
19624
+ * `geo_locations`, `custom_audiences`, `excluded_custom_audiences`, `flexible_spec`,
19625
+ * `targeting_automation`, etc.). Use it to target specific custom or lookalike audiences,
19626
+ * or to clone a campaign's targeting exactly. Mutually exclusive with `targeting` (sending
19627
+ * both → 422). Sent as-is; Meta validates and surfaces any errors.
19628
+ *
19629
+ */
19630
+ rawTargeting?: {
19631
+ [key: string]: unknown;
19632
+ };
19622
19633
  /**
19623
19634
  * Meta only. Tracking specs (pixel, URL tags).
19624
19635
  */
@@ -19987,6 +19998,36 @@ export type CreateStandaloneAdData = {
19987
19998
  name?: string;
19988
19999
  address?: string;
19989
20000
  }>;
20001
+ /**
20002
+ * Named points of interest (businesses, landmarks). Meta only. `key` from /v1/ads/targeting/search?dimension=geo&geoType=place. Maps to geo_locations.places.
20003
+ */
20004
+ places?: Array<{
20005
+ key: string;
20006
+ }>;
20007
+ /**
20008
+ * Named neighbourhood areas. Meta only. `key` from /v1/ads/targeting/search?dimension=geo&geoType=neighborhood. Maps to geo_locations.neighborhoods.
20009
+ */
20010
+ neighborhoods?: Array<{
20011
+ key: string;
20012
+ }>;
20013
+ /**
20014
+ * Geo exclusions. Meta only. Maps to excluded_geo_locations. Supports countries, regions, cities, and zips.
20015
+ */
20016
+ excludedLocations?: {
20017
+ /**
20018
+ * ISO-3166 alpha-2 country codes to exclude.
20019
+ */
20020
+ countries?: Array<(string)>;
20021
+ regions?: Array<{
20022
+ key: string;
20023
+ }>;
20024
+ cities?: Array<{
20025
+ key: string;
20026
+ }>;
20027
+ zips?: Array<{
20028
+ key: string;
20029
+ }>;
20030
+ };
19990
20031
  /**
19991
20032
  * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok. Each must include id.
19992
20033
  */
@@ -20533,7 +20574,51 @@ export type CreateLeadFormData = {
20533
20574
  thankYouButtonText?: string;
20534
20575
  thankYouButtonType?: string;
20535
20576
  thankYouWebsiteUrl?: string;
20577
+ /**
20578
+ * Legacy form type toggle. Prefer formType instead. false = More Volume, true = Higher Intent.
20579
+ */
20536
20580
  isOptimizedForQuality?: boolean;
20581
+ /**
20582
+ * Form type. MORE_VOLUME = optimized for lead quantity (default). HIGHER_INTENT = adds a review/confirmation step before submit. RICH_CREATIVE = includes context card and custom headline to educate users before they submit. Supersedes isOptimizedForQuality.
20583
+ */
20584
+ formType?: 'MORE_VOLUME' | 'HIGHER_INTENT' | 'RICH_CREATIVE';
20585
+ /**
20586
+ * Sharing setting. true = Restricted (only people targeted by the ad can open the form link). false = Open (shareable link, default).
20587
+ */
20588
+ blockDisplayForNonTargetedViewer?: boolean;
20589
+ /**
20590
+ * Flexible form delivery. true = the form can surface organically on the Page (not just as a paid ad). Defaults to false.
20591
+ */
20592
+ allowOrganicLeadGen?: boolean;
20593
+ /**
20594
+ * Custom subheadline shown above the form fields on the questions page (the contact-information section description). Defaults to Meta's generic copy when omitted.
20595
+ */
20596
+ questionPageCustomHeadline?: string;
20597
+ /**
20598
+ * Intro card shown before the questions page. Omit to skip the intro screen.
20599
+ */
20600
+ contextCard?: {
20601
+ /**
20602
+ * Headline / title of the intro card.
20603
+ */
20604
+ title?: string;
20605
+ /**
20606
+ * Body text lines shown on the intro card.
20607
+ */
20608
+ content?: Array<(string)>;
20609
+ /**
20610
+ * Visual layout of the intro card.
20611
+ */
20612
+ style?: 'LIST_STYLE' | 'PARAGRAPH_STYLE';
20613
+ /**
20614
+ * CTA button label on the intro card.
20615
+ */
20616
+ buttonText?: string;
20617
+ /**
20618
+ * Image hash of the cover photo (obtain from the Meta Ad Images API). Omit to show no image.
20619
+ */
20620
+ coverPhoto?: string;
20621
+ };
20537
20622
  };
20538
20623
  };
20539
20624
 
@@ -20730,9 +20815,9 @@ export type SearchAdTargetingData = {
20730
20815
  */
20731
20816
  dimension?: 'geo' | 'interest' | 'behavior' | 'income';
20732
20817
  /**
20733
- * Only used when `dimension=geo`. The kind of location to resolve. `place` resolves named points of interest (businesses, landmarks) by proximity. `neighborhood` resolves named neighbourhood areas. Defaults to `city`.
20818
+ * Only used when `dimension=geo`. The kind of location to resolve. `place` resolves named points of interest (businesses, landmarks). `neighborhood` resolves named neighbourhood areas. Use `all` to search every geo type in a single relevance-ranked call — mirrors Meta's own unified search box. Defaults to `city`.
20734
20819
  */
20735
- geoType?: 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
20820
+ geoType?: 'all' | 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
20736
20821
  /**
20737
20822
  * Maximum results to return.
20738
20823
  */
@@ -20766,6 +20851,14 @@ export type SearchAdTargetingResponse = ({
20766
20851
  * Optional estimated reachable users for this option, when the platform returns it.
20767
20852
  */
20768
20853
  audienceSize?: (number) | null;
20854
+ /**
20855
+ * Centre latitude of the location. Populated on Meta geo results (city, neighborhood, place, etc.). Useful for map views.
20856
+ */
20857
+ latitude?: (number) | null;
20858
+ /**
20859
+ * Centre longitude of the location.
20860
+ */
20861
+ longitude?: (number) | null;
20769
20862
  }>;
20770
20863
  });
20771
20864